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": "…" } }엔드포인트
/v1/me계정.
{ "success": true, "data": { "id": 123, "email": "[email protected]", "name": "You", "balance": 45.00 } }/v1/balance현재 계정 잔액 (USD).
/v1/donorsMarketplace 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 } }/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바구니에 백링크 주문을 생성하세요 — 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" } }/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 키로 인증하고, GET /v1/me 계정 확인을 위해, GET /v1/donors 사이트를 찾은 뒤, POST /v1/orders → POST /v1/basket/pay 주문 및 게시. HTTP를 완전히 생략하고 를 사용할 수도 있습니다. MCP 서버 — 동일한 키, 네이티브 도구.