Посібник API BuyLinksForSEO

Підключіть дослідження видавців і замовлення зворотних посилань до ваших власних інструментів. Ця довідка охоплює автентифікацію, формати запитів, робочий процес від замовлення до публікації та відповіді. Ваші інтеграції використовують той самий баланс і замовлення, що й ваш акаунт BuyLinksForSEO.

Отримати API-ключПідключити ШІ-агента (MCP) →

Базовий URL і автентифікація

  • Базовий URL https://buylinksforseo.com
  • Префікс версії /v1
  • Auth Authorization: Bearer <your_api_key> (або ?api_key=…)
  • Тип контенту application/json

Створюйте та копіюйте ключі у вашій панелі → API. Ключ належить одному обліковому запису і діє на цей обліковий запис. API може робити все, крім поповнення вашого балансу — додавання коштів залишається в панелі.

Формат відповіді

Кожна відповідь — JSON. Конверти успіху та помилок:

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

Кінцеві точки

GET/v1/me

Ваш обліковий запис.

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

Поточний баланс рахунку (USD).

GET/v1/donors

Сайти-донори маркетплейсу (з пагінацією, 20/сторінку). Необов'язкові параметри запиту: 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

Повертає точний промпт, який ми використовуємо для написання статті — тож ви можете його прочитати та відредагувати. Необов'язкові параметри запиту: keyword, target_url, language, recommendations. Відредагуйте повернутий промпт і передайте його назад до POST /v1/orders як recommendations; зберігайте OUTPUT FORMAT блок і він запускається дослівно.

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

Створіть замовлення зворотних посилань у кошику — no charge yet. donor_ids завжди обов'язковий; потім виберіть один із трьох режимів контенту:

  • Авто — надіслати target_url + keyword; ми досліджуємо тему та пишемо статтю.
  • З вашого запиту — також надсилати recommendations (отримати та редагувати базовий промпт через GET /v1/article-prompt); ми пишемо за вашим брифом.
  • Ваша власна стаття — надіслати content (+ опціонально title, article_url); ми публікуємо ваш готовий HTML як є. Потребує ввімкнення власного контенту у вашому акаунті.
// 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

Перевірте, що зараз у вашому кошику (підготовлені статті, донор, ціна), перш ніж публікувати.

POST/v1/basket/pay

Опублікуйте все зі свого кошика, оплативши з балансу акаунта. Якщо балансу недостатньо, нічого не публікується і повертається success:false скільки ще потрібно. Поповнення доступне лише в дашборді.

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

Ваші замовлені посилання (зворотні посилання) зі статусом і опублікованим URL. /v1/orders (GET) є псевдонімом.

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

Процес замовлення

  1. Знайти сайти — GET /v1/donors для вибору релевантних донорів із реальним трафіком.
  2. Замовлення — POST /v1/orders з ідентифікаторами донорів і вашою сторінкою/ключовим словом → позиції потрапляють у ваш кошик. Виберіть режим контенту: автоматичний, ваш відредагований промпт (recommendations див. GET /v1/article-prompt), або вашого власного content.
  3. Відгук — GET /v1/basket щоб перевірити чернетки та підсумок.
  4. Опублікувати — POST /v1/basket/pay сплачує з вашого балансу та запускає посилання (~24 год).
  5. Відстежувати — GET /v1/links для статусу та опублікованих URL-адрес.

Помилки

  • 401 unauthorized — відсутній / недійсний / відкликаний ключ
  • 400 bad_request / payment_failed — некоректне тіло, або баланс не покриває кошик
  • 403 forbidden / own_content_disabled — ключ не може замовляти, або own-content не ввімкнено у вашому обліковому записі
  • 404 not_found — невідомий ендпоінт чи ресурс
  • 405 method_not_allowed
  • 500 server_error — тимчасовий; повторіть

Для AI-агентів: автентифікуйтесь за допомогою ключа Bearer, викликайте GET /v1/me для підтвердження облікового запису, GET /v1/donors для пошуку сайтів, потім POST /v1/orders → POST /v1/basket/pay для замовлення та публікації. Або повністю пропустіть HTTP і використовуйте MCP сервер — той самий ключ, нативні інструменти.