BuyLinksForSEO API 指南

将出版商研究和反向链接下单连接到你的自有工具。本参考涵盖身份验证、请求格式、从下单到发布的完整工作流及响应。你的集成使用与 BuyLinksForSEO 账号相同的余额和订单。

获取您的 API 密钥连接 AI 智能体(MCP) →

基础 URL 与认证

  • 基础 URL https://buylinksforseo.com
  • 版本前缀 /v1
  • Auth Authorization: Bearer <your_api_key> (or ?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

当前账户余额(美元)。

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 as 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 (+ optional 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 随发布者 ID 和您的页面/关键词 → 商品进入您的购物篮。选择内容模式:自动、您编辑后的提示(recommendations，请参阅 GET /v1/article-prompt），或您自己的 content.
  3. 评论 — GET /v1/basket 核对稿件及总金额。
  4. 发布 — POST /v1/basket/pay 从您的余额中扣除费用并将链接推送上线（约 24 小时）。
  5. 跟踪 — GET /v1/links 用于状态和已发布的网址。

错误

  • 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服务器 — 同一密钥,原生工具。