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
/v1/meTài khoản của bạn.
{ "success": true, "data": { "id": 123, "email": "[email protected]", "name": "You", "balance": 45.00 } }/v1/balanceSố dư tài khoản hiện tại (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-promptTrả 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": "…" } } }/v1/ordersTạ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 quaGET /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ọntitle,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" } }/v1/basketKiể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.
/v1/basket/payXuấ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 } }/v1/linksCá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
- 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. - Đặt hàng —
POST /v1/ordersvớ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, xemGET /v1/article-prompt), hoặc của riêng bạncontent. - Đánh giá —
GET /v1/basketđể kiểm tra các bản nháp và tổng cộng. - Xuất bản —
POST /v1/basket/paythanh toán từ số dư của bạn và đẩy các liên kết lên trực tiếp (~24h). - Theo dõi —
GET /v1/linkscho 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.