Руководство по API BuyLinksForSEO

Свяжите исследования издателей и заказы обратных ссылок с вашими собственными инструментами. Этот справочник охватывает аутентификацию, форматы запросов, рабочий процесс от заказа до публикации и ответы. Ваши интеграции используют тот же баланс и заказы, что и ваша учётная запись BuyLinksForSEO.

Получить ваш API-ключПодключите AI-агента (MCP) →

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

  • Базовый URL https://buylinksforseo.com
  • Префикс версии /v1
  • Авторизация 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

Создайте заказ(ы) на обратные ссылки в корзину — пока без оплаты. 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 — ключ не может оформлять заказы или собственный контент не включён в вашей учётной записи
  • 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-сервер — тот же ключ, нативные инструменты.