De BuyLinksForSEO API-handleiding

Verbind uitgeverersonderzoek en backlink-bestellingen met je eigen tools. Deze referentie behandelt authenticatie, verzoekformaten, de workflow van bestelling tot publicatie en antwoorden. Je integraties gebruiken hetzelfde saldo en dezelfde bestellingen als je BuyLinksForSEO-account.

Uw API-sleutel ophalenVerbind een AI-agent (MCP) →

Basis URL & authenticatie

  • Basis URL https://buylinksforseo.com
  • Versieprefix /v1
  • Authentiek Authorization: Bearer <your_api_key> (of ?api_key=…)
  • Contenttype application/json

Sleutels maken en kopiëren in uw dashboard → API. Een sleutel hoort bij één account en werkt op dat account. De API kan alles behalve uw saldo opwaarderen — het toevoegen van fondsen blijft in het dashboard.

Responsformaat

Elke respons is JSON. Succes- en foutenveloppes:

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

Eindpunten

GET/v1/me

Uw account.

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

Huidige accountsaldo (USD).

GET/v1/donors

Marketplace donor-sites (met paginering, 20/pagina). Optionele query-parameters: 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

Retourneert de exacte prompt die we gebruiken om het artikel te schrijven — zodat u het kunt lezen en bewerken. Optionele query-parameters: keyword, target_url, language, recommendations. Bewerk de geretourneerde prompt en geef deze terug aan POST /v1/orders als recommendations; behoud de OUTPUT FORMAT blok en het wordt verbatim uitgevoerd.

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

Maak backlinkbestelling(en) in uw mandje — no charge yet. donor_ids is altijd verplicht; kies vervolgens een van drie contentmodi:

  • Auto — stuur target_url + keyword; wij onderzoeken & schrijven het artikel.
  • Van uw prompt — stuur ook recommendations (ophalen & bewerken van de basisprompt via GET /v1/article-prompt); wij schrijven volgens uw briefing.
  • Uw eigen artikel — stuur content (+ optioneel title, article_url); wij publiceren uw kant-en-klare HTML zoals het is. Vereist eigen-inhoud ingeschakeld op uw 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

Bekijk wat er momenteel in je mandje zit (opgestelde artikelen, donor, prijs) voordat je publiceert.

POST/v1/basket/pay

Publiceer alles in uw mand, betaald van uw accountsaldo. Als het saldo ontoereikend is, wordt er niets gepubliceerd en geretourneerd success:false hoeveel er nog meer nodig is. Opwaarderen kan alleen in het dashboard.

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

Uw bestelde links (backlinks) met status en gepubliceerde URL. /v1/orders (GET) is een 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" } ] }

Bestelproces

  1. Sites zoeken — GET /v1/donors om relevante, echt-verkeer donors te kiezen.
  2. Bestellen — POST /v1/orders met de donor-ids en uw pagina/trefwoord → items belanden in uw winkelmand. Kies de contentmodus: automatisch, uw bewerkte prompt (recommendations, zie GET /v1/article-prompt), of uw eigen content.
  3. Beoordeling — GET /v1/basket om de concepten en het totaal te controleren.
  4. Publiceren — POST /v1/basket/pay betaalt vanuit uw saldo en plaatst de links live (~24u).
  5. Volgen — GET /v1/links voor status en gepubliceerde URL's.

Fouten

  • 401 unauthorized — ontbrekende / ongeldige / ingetrokken sleutel
  • 400 bad_request / payment_failed — slechte body, of het saldo dekt de winkelmand niet
  • 403 forbidden / own_content_disabled — sleutel kan niet bestellen, of eigen content is niet ingeschakeld op uw account
  • 404 not_found — onbekend eindpunt of bron
  • 405 method_not_allowed
  • 500 server_error — tijdelijk; opnieuw proberen

Voor AI-agents: authenticeer met de Bearer-sleutel, bel GET /v1/me om het account te bevestigen, GET /v1/donors om sites te vinden, dan POST /v1/orders → POST /v1/basket/pay om te bestellen en te publiceren. Of sla HTTP volledig over en gebruik de MCP-server — dezelfde sleutel, native tools.