BuyLinksForSEOのAPIガイド

パブリッシャー調査と被リンク注文をあなたのツールに接続。このリファレンスでは認証、リクエスト形式、注文から公開までのワークフロー、レスポンスを網羅します。インテグレーションは BuyLinksForSEO アカウントと同じ残高と注文を使用します。

ベース URL & 認証

  • ベース URL https://buylinksforseo.com
  • バージョンのプレフィックス /v1
  • オーセンティシティ Authorization: Bearer <your_api_key> (または ?api_key=…)
  • コンテンツタイプ application/json

ダッシュボードでキーを作成してコピー → API。キーは1つのアカウントに属し、そのアカウントに対して動作します。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 が常に必要です。その後、 3つのコンテンツモードのいずれか:

  • 自動車 — 送信 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 寄稿者IDとページ/キーワードと共に → アイテムがバスケットに入ります。コンテンツモードを選択: 自動、編集したプロンプト(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キーで認証し、次のURLを呼び出します GET /v1/me アカウントを確認するために、 GET /v1/donors サイトを見つけ、その次に POST /v1/orders → POST /v1/basket/pay 発注と公開を行うため。あるいはHTTPを完全にスキップして MCPサーバー — 同じキー、ネイティブツール。