Hướng dẫn API của BuyLinksForSEO

Kết nối nghiên cứu publisher và đơn hàng backlink với các công cụ của riêng bạn. Tài liệu tham khảo này bao gồm xác thực, định dạng request, quy trình từ đơn hàng đến xuất bản và response. Các tích hợp của bạn sử dụng cùng số dư và đơn hàng như tài khoản BuyLinksForSEO của bạn.

URL cơ sở & xác thực

  • URL cơ sở https://buylinksforseo.com
  • Tiền tố phiên bản /v1
  • Xác thực Authorization: Bearer <your_api_key> (hoặc ?api_key=…)
  • Loại nội dung application/json

Tạo và sao chép khóa trong bảng điều khiển của bạn → API. Một khóa thuộc về một tài khoản và hoạt động trên tài khoản đó. API có thể thực hiện mọi thứ ngoại trừ nạp tiền vào số dư của bạn — việc nạp tiền được thực hiện ngay trong dashboard.

Định dạng phản hồi

Mọi phản hồi là JSON. Phong bì thành công và lỗi:

{ "success": true, "data": { … } }
{ "success": false, "error": { "code": "unauthorized", "message": "…" } }

Endpoints

GET/v1/me

Tài khoản của bạn.

{ "success": true, "data": { "id": 123, "email": "[email protected]", "name": "You", "balance": 45.00 } }
GET/v1/balance

Số dư tài khoản hiện tại (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

Trả về chính xác prompt chúng tôi dùng để viết bài — để bạn đọc và chỉnh sửa. Tham số truy vấn tùy chọn: keyword, target_url, language, recommendations. Chỉnh sửa prompt được trả về và truyền lại cho POST /v1/orders dưới dạng recommendations; giữ nguyên OUTPUT FORMAT khối và nó chạy nguyên văn.

{ "success": true, "data": { "default_prompt": "…", "editable_field": "recommendations",
    "modes": { "own": "…", "prompt": "…", "auto": "…" } } }
POST/v1/orders

Tạo (các) đơn hàng backlink vào giỏ hàng của bạn — no charge yet. donor_ids luôn bắt buộc; sau đó chọn một trong ba chế độ nội dung:

  • Tự động — send target_url + keyword; chúng tôi nghiên cứu & viết bài.
  • Từ lời nhắc của bạn — also send recommendations (tìm nạp & chỉnh sửa prompt cơ bản qua GET /v1/article-prompt); chúng tôi viết theo brief của bạn.
  • Bài viết riêng của bạn — send content (+ tùy chọn title, article_url); chúng tôi đăng tải nguyên văn HTML đã sẵn sàng của bạn. Yêu cầu bật tính năng nội dung riêng trên tài khoản của bạn.
// 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

Kiểm tra những gì hiện có trong giỏ hàng của bạn (các bài viết đã soạn thảo, trang nguồn, giá) trước khi xuất bản.

POST/v1/basket/pay

Xuất bản tất cả trong giỏ hàng của bạn, thanh toán từ số dư tài khoản. Nếu số dư không đủ thì không xuất bản gì cả và hoàn trả success:false với việc cần thêm bao nhiêu. Việc bổ sung chỉ thực hiện được trên bảng điều khiển.

{ "success": true, "data": { "status": "published", "charged": 24, "links": 2 } }
GET/v1/links

Các link (backlink) bạn đã đặt kèm trạng thái và URL đã xuất bản. /v1/orders (GET) là một bí danh.

{ "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" } ] }

Quy trình đặt hàng

  1. Tìm trang web — GET /v1/donors để chọn các trang nguồn phù hợp có lưu lượng truy cập thực.
  2. Đặt hàng — POST /v1/orders với id của trang liên kết và trang/từ khóa của bạn → các mục sẽ được thêm vào giỏ hàng. Chọn chế độ nội dung: tự động, lời nhắc bạn đã chỉnh sửa (recommendations, xem GET /v1/article-prompt), hoặc của riêng bạn content.
  3. Đánh giá — GET /v1/basket để kiểm tra các bản nháp và tổng cộng.
  4. Xuất bản — POST /v1/basket/pay thanh toán từ số dư của bạn và đẩy các liên kết lên trực tiếp (~24h).
  5. Theo dõi — GET /v1/links cho trạng thái và các URL đã xuất bản.

Lỗi

  • 401 unauthorized — missing / invalid / revoked key
  • 400 bad_request / payment_failed — nội dung kém chất lượng, hoặc số dư không đủ để thanh toán giỏ hàng
  • 403 forbidden / own_content_disabled — khóa không thể đặt hàng, hoặc nội dung riêng không được bật trên tài khoản của bạn
  • 404 not_found — unknown endpoint or resource
  • 405 method_not_allowed
  • 500 server_error — transient; retry

Dành cho các tác nhân AI: xác thực bằng khóa Bearer, gọi GET /v1/me để xác nhận tài khoản, GET /v1/donors để tìm trang, sau đó POST /v1/orders → POST /v1/basket/pay để đặt hàng và xuất bản. Hoặc bỏ qua HTTP hoàn toàn và sử dụng Máy chủ MCP — same key, native tools.