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": "…" } }エンドポイント
/v1/meあなたのアカウント。
{ "success": true, "data": { "id": 123, "email": "[email protected]", "name": "You", "balance": 45.00 } }/v1/balance現在のアカウント残高(USD)。
/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 } }/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": "…" } } }/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" } }/v1/basket公開前に、現在バスケットの中身(ドラフト記事、ドナー、価格)を確認してください。
/v1/basket/payアカウント残高から支払い、バスケット内のすべてを公開します。残高が不足している場合、何も公開されず、戻ります success:false あとどのくらい必要か。チャージはダッシュボードのみで完結します。
{ "success": true, "data": { "status": "published", "charged": 24, "links": 2 } }/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" } ] }注文フロー
- サイトを探す —
GET /v1/donors関連性が高く、実トラフィックのある寄稿者を選ぶため。 - 注文 —
POST /v1/orders寄稿者IDとページ/キーワードと共に → アイテムがバスケットに入ります。コンテンツモードを選択: 自動、編集したプロンプト(recommendations、詳細はGET /v1/article-prompt)、またはお客様が所有するcontent. - レビュー —
GET /v1/basketドラフトと合計金額を確認するため。 - 公開 —
POST /v1/basket/pay残高から支払い、リンクを公開します(約24時間)。 - 追跡 —
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サーバー — 同じキー、ネイティブツール。