La guida API di BuyLinksForSEO

Connetti la ricerca degli editori e gli ordini di backlink ai tuoi strumenti. Questa reference copre autenticazione, formati delle richieste, flusso di lavoro dall'ordine alla pubblicazione e risposte. Le tue integrazioni utilizzano lo stesso saldo e gli stessi ordini del tuo account BuyLinksForSEO.

Ottieni la tua chiave APIConnetti un agente AI (MCP) →

URL di base e autenticazione

  • URL di base https://buylinksforseo.com
  • Prefisso versione /v1
  • Autenticità Authorization: Bearer <your_api_key> (oppure ?api_key=…)
  • Tipo di contenuto application/json

Crea e copia le chiavi nella tua dashboard → API. Una chiave appartiene a un account e agisce su quell'account. L'API può fare tutto tranne ricaricare il tuo saldo — aggiungere fondi rimane nella dashboard.

Formato della risposta

Ogni risposta è in JSON. Envelope di successo ed errore:

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

Endpoints

GET/v1/me

Il tuo account.

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

Saldo attuale del conto (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

Restituisce il prompt esatto che usiamo per scrivere l'articolo — così puoi leggerlo e modificarlo. Parametri di query opzionali: keyword, target_url, language, recommendations. Modifica il prompt restituito e passalo di nuovo a POST /v1/orders as recommendations; mantieni il OUTPUT FORMAT block e viene eseguito verbatim.

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

Crea uno o più ordini di backlink nel tuo carrello — no charge yet. donor_ids è sempre obbligatorio; poi scegli una delle tre modalità di contenuto:

  • Auto — invia target_url + keyword; noi ci occupiamo della ricerca e scriviamo l'articolo.
  • Dal tuo prompt — invia anche recommendations (recupera e modifica il prompt di base tramite GET /v1/article-prompt); scriviamo secondo il tuo brief.
  • Il tuo articolo — invia content (+ opzionale title, article_url); pubblichiamo il tuo HTML pronto così com'è. Richiede la funzionalità contenuti propri attiva sul tuo account.
// 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

Controlla cosa c'è attualmente nel tuo carrello (articoli in bozza, donatore, prezzo) prima di pubblicare.

POST/v1/basket/pay

Pubblica tutto nel tuo carrello, pagando dal saldo del tuo account. Se il saldo è insufficiente non pubblica nulla e restituisce success:false con quanto manca ancora. La ricarica è solo nella dashboard.

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

I tuoi link ordinati (backlink) con stato e URL pubblicato. /v1/orders (GET) è un 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" } ] }

Flusso di ordinazione

  1. Trova siti — GET /v1/donors per scegliere donatori rilevanti, con traffico reale.
  2. Ordine — POST /v1/orders con gli id dei donatori e la tua pagina/keyword → gli articoli finiscono nel carrello. Scegli la modalità contenuto: auto, il tuo prompt modificato (recommendations vedi GET /v1/article-prompt), oppure il tuo content.
  3. Recensione — GET /v1/basket per controllare le bozze e il totale.
  4. Pubblica — POST /v1/basket/pay paga dal tuo saldo e pubblica i link (~24h).
  5. Monitora — GET /v1/links per lo stato e gli URL pubblicati.

Errori

  • 401 unauthorized — chiave mancante / non valida / revocata
  • 400 bad_request / payment_failed — body non valido, o il saldo non copre il carrello
  • 403 forbidden / own_content_disabled — la chiave non può ordinare, o il contenuto proprio non è abilitato sul tuo account
  • 404 not_found — endpoint o risorsa sconosciuta
  • 405 method_not_allowed
  • 500 server_error — transitorio; riprova

Per agenti AI: autenticati con la chiave Bearer, chiama GET /v1/me per confermare l'account, GET /v1/donors per trovare siti, poi POST /v1/orders → POST /v1/basket/pay per ordinare e pubblicare. Oppure salta del tutto HTTP e usa il Server MCP — stessa chiave, strumenti nativi.