BuyLinksForSEO API 가이드

게시자 리서치 및 백링크 주문을 자체 도구에 연결하세요. 이 참조는 인증, 요청 형식, 주문에서 게시까지의 워크플로 및 응답을 다룹니다. 통합은 BuyLinksForSEO 계정의 동일한 잔액 및 주문을 사용합니다.

기본 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

Marketplace donor sites (paginated, 20/page). Optional query params: 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)에 사용할 수 있습니다; ready 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 키로 인증하고, GET /v1/me 계정 확인을 위해, GET /v1/donors 사이트를 찾은 뒤, POST /v1/orders → POST /v1/basket/pay 주문 및 게시. HTTP를 완전히 생략하고 를 사용할 수도 있습니다. MCP 서버 — 동일한 키, 네이티브 도구.