Guia da API da BuyLinksForSEO

Conecte a pesquisa de publishers e os pedidos de backlinks às suas próprias ferramentas. Esta referência abrange autenticação, formatos de requisição, o fluxo de pedido até a publicação e as respostas. Suas integrações usam o mesmo saldo e pedidos da sua conta BuyLinksForSEO.

Obtenha sua chave de APIConectar um agente de IA (MCP) →

URL base e autenticação

  • URL base https://buylinksforseo.com
  • Prefixo da versão /v1
  • Autenticação Authorization: Bearer <your_api_key> (ou ?api_key=…)
  • Tipo de conteúdo application/json

Crie e copie chaves no seu painel → API. Uma chave pertence a uma conta e atua nessa conta. A API pode fazer tudo, exceto recarregar seu saldo — adicionar fundos permanece no painel.

Formato de resposta

Cada resposta é JSON. Envelopes de sucesso e erro:

{ "success": true, "data": { … } }
{ "success": false, "error": { "code": "unauthorized", "message": "…" } }

Endpoints

GET/v1/me

Sua conta.

{ "success": true, "data": { "id": 123, "email": "[email protected]", "name": "You", "balance": 45.00 } }
GET/v1/balance

Saldo atual da conta (USD).

GET/v1/donors

Marketplace donor sites (paginated, 20/page). Optional query params: page, domain_filter, ext_filter, dr_min, referring_domains_min, price_filter, top100_filter.

{ "success": true, "data": [ { "id": 42, "domain": "blog.com", "dr": 61, "price": 12 } ],
  "pagination": { "current_page": 1, "total_pages": 478, "total_records": 9543 } }
GET/v1/article-prompt

Retorna o prompt exato que usamos para escrever o artigo — para que você possa lê-lo e editá-lo. Parâmetros opcionais: keyword, target_url, language, recommendations. Edite o prompt retornado e passe-o de volta para POST /v1/orders as recommendations; mantenha o OUTPUT FORMAT bloco e ele roda de forma idêntica.

{ "success": true, "data": { "default_prompt": "…", "editable_field": "recommendations",
    "modes": { "own": "…", "prompt": "…", "auto": "…" } } }
POST/v1/orders

Crie pedido(s) de backlinks no seu carrinho — no charge yet. donor_ids é sempre obrigatório; depois escolha um dos três modos de conteúdo:

  • Automático — enviar target_url + keyword; nós pesquisamos e escrevemos o artigo.
  • Do seu prompt — também envia recommendations (obtenha e edite o prompt base via GET /v1/article-prompt); escrevemos de acordo com seu briefing.
  • Seu próprio artigo — enviar content (+ opcional title, article_url); publicamos seu HTML pronto como está. Requer conteúdo próprio ativado na sua conta.
// auto
{ "donor_ids": [42, 43], "target_url": "https://you.com/pricing", "keyword": "best crm", "language": "en" }
// from your prompt
{ "donor_ids": [42], "target_url": "https://you.com", "keyword": "best crm", "recommendations": "Friendly tone, cite 2 studies…" }
// your own article
{ "donor_ids": [42], "content": "<article>…</article>", "title": "My headline" }
{ "success": true, "data": { "mode": "auto", "order_content_ids": [9001, 9002],
    "basket_ids": [55, 56], "total_price": 24, "status": "in_basket" } }
GET/v1/basket

Inspecione o que está atualmente no seu carrinho (artigos elaborados, doador, preço) antes de publicar.

POST/v1/basket/pay

Publique tudo no seu carrinho, pagando do saldo da sua conta. Se o saldo for insuficiente, nada é publicado e retorna success:false com quanto mais ainda é necessário. Recargas são apenas pelo painel.

{ "success": true, "data": { "status": "published", "charged": 24, "links": 2 } }
GET/v1/links

Seus links pedidos (backlinks) com status e URL publicada. /v1/orders (GET) é um alias.

{ "success": true, "count": 1, "data": [
  { "id": 8891, "target_url": "https://you.com/pricing", "keyword": "best crm",
    "status": "active", "published_url": "https://donor.com/…?aio-…", "cost": "12.00" } ] }

Fluxo de pedido

  1. Encontrar sites — GET /v1/donors para selecionar doadores relevantes, com tráfego real.
  2. Pedir — POST /v1/orders com os IDs dos doadores e sua página/palavra-chave → os itens vão para o seu carrinho. Escolha o modo de conteúdo: automático, seu prompt editado (recommendations , consulte GET /v1/article-prompt), ou seu próprio content.
  3. Revisão — GET /v1/basket para conferir os rascunhos e o total.
  4. Publicar — POST /v1/basket/pay paga do seu saldo e coloca os links no ar (~24h).
  5. Acompanhar — GET /v1/links para status e URLs publicadas.

Erros

  • 401 unauthorized — chave ausente / inválida / revogada
  • 400 bad_request / payment_failed — corpo inválido ou o saldo não cobre o carrinho
  • 403 forbidden / own_content_disabled — chave não pode fazer pedidos ou conteúdo próprio não está habilitado na sua conta
  • 404 not_found — endpoint ou recurso desconhecido
  • 405 method_not_allowed
  • 500 server_error — transitório; tente novamente

Para agentes de IA: autentique-se com a chave Bearer, chame GET /v1/me para confirmar a conta, GET /v1/donors para encontrar sites, então POST /v1/orders → POST /v1/basket/pay para pedir e publicar. Ou pule o HTTP por completo e use o Servidor MCP — mesma chave, ferramentas nativas.