คู่มือ API ของ BuyLinksForSEO

เชื่อมต่อการวิจัยผู้เผยแพร่และคำสั่งซื้อแบ็คลิงก์กับเครื่องมือของคุณเอง ข้อมูลอ้างอิงนี้ครอบคลุมการรับรองความถูกต้อง รูปแบบคำขอ เวิร์กโฟลว์คำสั่งซื้อถึงการเผยแพร่ และการตอบกลับ การผสานรวมของคุณใช้ยอดเงินและคำสั่งซื้อเดียวกับบัญชี BuyLinksForSEO ของคุณ

URL ฐานและการยืนยันตัวตน

  • URL ฐาน https://buylinksforseo.com
  • คำนำหน้าเวอร์ชัน /v1
  • Auth Authorization: Bearer <your_api_key> (หรือ ?api_key=…)
  • ประเภทเนื้อหา application/json

สร้างและคัดลอก Keys ในแดชบอร์ดของคุณ → API. คีย์หนึ่งๆ เป็นของบัญชีเดียวและใช้กับบัญชีนั้น API สามารถทำทุกอย่างได้ ยกเว้นเติมยอดเงินของคุณ — การเติมเงินยังคงอยู่ในแดชบอร์ด.

รูปแบบการตอบกลับ

ทุกการตอบกลับเป็น JSON ซองจดหมายสำเร็จและข้อผิดพลาด:

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

Endpoints

GET/v1/me

บัญชีของคุณ

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

ยอดเงินในบัญชีปัจจุบัน (USD)

GET/v1/donors

ไซต์ผู้บริจาคใน Marketplace (แบ่งหน้า 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 } }
GET/v1/article-prompt

ส่งคืนพรอมต์ที่เราใช้เขียนบทความอย่างแม่นยำ — เพื่อให้คุณอ่านและแก้ไขได้ พารามิเตอร์เพิ่มเติม: keyword, target_url, language, recommendations. แก้ไขพรอมต์ที่ส่งคืนแล้วส่งกลับไปยัง POST /v1/orders as recommendations, รักษา OUTPUT FORMAT block และมันทำงานตามนั้น

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

สร้างคำสั่งซื้อ Backlink ใส่ในตะกร้าของคุณ — ยังไม่มีค่าใช้จ่าย. donor_ids จำเป็นเสมอ แล้วเลือก หนึ่งในสามโหมดเนื้อหา:

  • อัตโนมัติ — ส่ง target_url + keyword; เราค้นคว้า & เขียนบทความ
  • จาก prompt ของคุณ — ส่ง recommendations (ดึงและแก้ไข base prompt ผ่าน GET /v1/article-prompt); เราจะเขียนตาม brief ของคุณ
  • บทความของคุณเอง — ส่ง content (+ ตัวเลือกเพิ่มเติม) title, article_url); เราจะเผยแพร่ HTML ที่พร้อมใช้งานของคุณตามที่เป็นอยู่ ต้องเปิดใช้งาน own-content บนบัญชีของคุณ
// 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) เป็น alias

{ "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 ด้วยรหัสผู้บริจาคและหน้า/คีย์เวิร์ดของคุณ → รายการจะลงในตะกร้าของคุณ เลือกโหมดเนื้อหา: อัตโนมัติ พรอมต์ที่แก้ไขของคุณ (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 — endpoint หรือทรัพยากรที่ไม่รู้จัก
  • 405 method_not_allowed
  • 500 server_error — ชั่วคราว ลองอีกครั้ง

สำหรับ AI agents: ยืนยันตัวตนด้วยคีย์ Bearer เรียก GET /v1/me เพื่อยืนยันบัญชี GET /v1/donors เพื่อค้นหาเว็บไซต์ จากนั้น POST /v1/orders → POST /v1/basket/pay เพื่อสั่งซื้อและเผยแพร่ หรือข้าม HTTP ไปเลยและใช้ เซิร์ฟเวอร์ MCP — คีย์เดียวกัน เครื่องมือเนทีฟ