Przewodnik po API BuyLinksForSEO

Połącz badania wydawców i zamówienia backlinków z własnymi narzędziami. Ta dokumentacja obejmuje uwierzytelnianie, formaty żądań, przepływ zamówienie-do-publikacji oraz odpowiedzi. Twoje integracje korzystają z tego samego salda i zamówień co Twoje konto BuyLinksForSEO.

Pobierz swój klucz APIPołącz agenta AI (MCP) →

URL bazowy i autentykacja

  • URL bazowy https://buylinksforseo.com
  • Prefiks wersji /v1
  • Uwierzytelnianie Authorization: Bearer <your_api_key> (lub ?api_key=…)
  • Typ treści application/json

Twórz i kopiuj klucze w panelu → API. Klucz należy do jednego konta i działa na tym koncie. API może zrobić wszystko oprócz doładowania salda — dodawanie środków pozostaje w pulpicie.

Response format

Każda odpowiedź to JSON. Koperty sukcesu i błędu:

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

Endpointy

GET/v1/me

Twoje konto.

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

Aktualne saldo konta (USD).

GET/v1/donors

Strony donorów marketplace (stronicowane, 20/stronę). Opcjonalne parametry zapytania: 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

Zwraca dokładny prompt, którego używamy do napisania artykułu — możesz go przeczytać i edytować. Opcjonalne parametry zapytania: keyword, target_url, language, recommendations. Edytuj zwrócony prompt i przekaż go ponownie do POST /v1/orders jako recommendations; zachowaj OUTPUT FORMAT blok i uruchamia się dosłownie.

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

Utwórz zamówienia na backlinki w koszyku — no charge yet. donor_ids jest zawsze wymagane; następnie wybierz jeden z trzech trybów treści:

  • Automatycznie — wyślij target_url + keyword; my badamy i piszemy artykuł.
  • Z Twojego promptu — także wyślij recommendations (pobierz i edytuj bazowy prompt przez GET /v1/article-prompt); piszemy zgodnie z Twoim briefem.
  • Twój własny artykuł — wyślij content (+ opcjonalnie title, article_url); publikujemy gotowy HTML w niezmienionej formie. Wymaga włączenia własnej treści na Twoim koncie.
// 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

Sprawdź, co aktualnie znajduje się w Twoim koszyku (projekty artykułów, darczyńca, cena) przed publikacją.

POST/v1/basket/pay

Opublikuj wszystko ze swojego koszyka, płacąc z salda konta. Jeśli saldo jest niewystarczające, nic nie zostanie opublikowane i zwraca success:false ile jeszcze potrzeba. Doładowanie dostępne jest tylko w panelu.

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

Twoje zamówione linki (backlinki) ze statusem i opublikowanym URL-em. /v1/orders (GET) jest aliasem.

{ "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" } ] }

Procedura zamawiania

  1. Znajdź strony — GET /v1/donors aby wybrać trafnych dawców z prawdziwym ruchem.
  2. Zamów — POST /v1/orders z identyfikatorami dawców i Twoją stroną/słowem kluczowym → pozycje trafiają do koszyka. Wybierz tryb treści: automatyczny, Twój edytowany prompt (recommendationszobacz GET /v1/article-prompt), lub Twojego własnego content.
  3. Recenzja — GET /v1/basket aby sprawdzić projekty i sumę.
  4. Opublikuj — POST /v1/basket/pay płaci z Twojego salda i uruchamia linki (~24h).
  5. Śledź — GET /v1/links na status i opublikowane adresy URL.

Błędy

  • 401 unauthorized — brakujący / nieprawidłowy / unieważniony klucz
  • 400 bad_request / payment_failed — nieprawidłowa treść lub saldo nie pokrywa koszyka
  • 403 forbidden / own_content_disabled — klucz nie może zamawiać lub własna treść nie jest włączona na Twoim koncie
  • 404 not_found — nieznany punkt końcowy lub zasób
  • 405 method_not_allowed
  • 500 server_error — chwilowy; spróbuj ponownie

Dla agentów AI: uwierzytelnij się kluczem Bearer, wywołaj GET /v1/me aby potwierdzić konto, GET /v1/donors aby znaleźć witryny, a następnie POST /v1/orders → POST /v1/basket/pay aby zamawiać i publikować. Lub całkowicie pomiń HTTP i użyj serwer MCP — ten sam klucz, natywne narzędzia.