Der BuyLinksForSEO API-Guide

Verbinden Sie Verlagsrecherche und Backlink-Bestellungen mit Ihren eigenen Tools. Diese Referenz behandelt Authentifizierung, Anfrageformate, den Bestellung-zu-Veröffentlichungs-Workflow und Antworten. Ihre Integrationen nutzen dasselbe Guthaben und dieselben Bestellungen wie Ihr BuyLinksForSEO-Konto.

Ihren API-Schlüssel abrufenKI-Agent (MCP) verbinden →

Basis-URL & Authentifizierung

  • Basis-URL https://buylinksforseo.com
  • Versionspräfix /v1
  • Authentizität Authorization: Bearer <your_api_key> (oder ?api_key=…)
  • Inhaltstyp application/json

Schlüssel im Dashboard erstellen und kopieren → API. Ein Schlüssel gehört zu einem Konto und wirkt auf dieses Konto. Die API kann alles außer dein Guthaben aufzuladen — Aufladen des Guthabens erfolgt im Dashboard.

Antwortformat

Jede Antwort ist JSON. Erfolgs- und Fehlerumschläge:

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

Endpunkte

GET/v1/me

Ihr Konto.

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

Aktueller Kontostand (USD).

GET/v1/donors

Marktplatz-Spenderseiten (paginiert, 20/Seite). Optionale Query-Parameter: 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

Gibt den exakten Prompt zurück, mit dem wir den Artikel schreiben – damit du ihn lesen und bearbeiten kannst. Optionale Query-Parameter: keyword, target_url, language, recommendations. Bearbeite den zurückgegebenen Prompt und übergib ihn an POST /v1/orders als recommendations; behalten OUTPUT FORMAT Block und wird wörtlich ausgeführt.

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

Backlink-Bestellung(en) in Ihren Warenkorb legen — noch keine Kosten. donor_ids ist immer erforderlich; dann wählen Sie eines von drei Content-Modi:

  • Automatisch — senden target_url + keyword; wir recherchieren und schreiben den Artikel.
  • Von deinem Prompt — sendet auch recommendations (Basis-Prompt abrufen und bearbeiten über GET /v1/article-prompt); wir schreiben dein Briefing.
  • Ihr eigener Artikel — senden content (+ optional title, article_url); wir veröffentlichen Ihr fertiges HTML unverändert. Erfordert aktivierten Eigencontent auf Ihrem Konto.
// 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

Prüfen Sie, was sich aktuell in Ihrem Warenkorb befindet (vorgeschlagene Artikel, Spender, Preis), bevor Sie veröffentlichen.

POST/v1/basket/pay

Alles in Ihrem Warenkorb veröffentlichen, bezahlt von Ihrem Kontoguthaben. Bei unzureichendem Guthaben wird nichts veröffentlicht und es wird zurückgegeben success:false wieviel noch benötigt wird. Das Aufladen erfolgt nur im Dashboard.

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

Ihre bestellten Links (Backlinks) mit Status und veröffentlichter URL. /v1/orders (GET) ist ein 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" } ] }

Bestellablauf

  1. Websites finden — GET /v1/donors um relevante, real-traffic Donors auszuwählen.
  2. Bestellen — POST /v1/orders mit den Donor-IDs und Ihrer Seite/Keyword → Artikel landen in Ihrem Warenkorb. Wählen Sie den Content-Modus: automatisch, Ihr bearbeiteter Prompt (recommendations, siehe GET /v1/article-prompt), oder Ihren eigenen content.
  3. Bewertung — GET /v1/basket um die Entwürfe und die Gesamtsumme zu prüfen.
  4. Veröffentlichen — POST /v1/basket/pay zahlt aus Ihrem Guthaben und schaltet die Links live (~24h).
  5. Verfolgen — GET /v1/links for Status und veröffentlichte URLs.

Fehler

  • 401 unauthorized — fehlender / ungültiger / widerrufener Schlüssel
  • 400 bad_request / payment_failed — ungültiger Body, oder das Guthaben deckt den Warenkorb nicht ab
  • 403 forbidden / own_content_disabled — Schlüssel kann nicht bestellen, oder Eigen-Content ist in Ihrem Konto nicht aktiviert
  • 404 not_found — unbekannter Endpunkt oder Ressource
  • 405 method_not_allowed
  • 500 server_error — transient; erneut versuchen

Für KI-Agenten: mit dem Bearer-Schlüssel authentifizieren, rufe GET /v1/me um das Konto zu bestätigen, GET /v1/donors um Websites zu finden, dann POST /v1/orders → POST /v1/basket/pay um zu bestellen und zu veröffentlichen. Oder überspringen Sie HTTP entirely und nutzen Sie die MCP-Server — gleicher Schlüssel, native Tools.