Panduan API BuyLinksForSEO

Hubungkan riset penerbit dan pesanan backlink ke alat Anda sendiri. Referensi ini mencakup autentikasi, format permintaan, alur kerja dari pesanan hingga publikasi, dan respons. Integrasi Anda menggunakan saldo dan pesanan yang sama dengan akun BuyLinksForSEO Anda.

Dapatkan kunci API AndaHubungkan agen AI (MCP) →

URL Dasar & autentikasi

  • URL Dasar https://buylinksforseo.com
  • Prefiks versi /v1
  • Otentikasi Authorization: Bearer <your_api_key> (atau ?api_key=…)
  • Jenis konten application/json

Buat dan salin kunci di dasbor Anda → API. Sebuah kunci milik satu akun dan bertindak atas akun tersebut. API dapat melakukan semua hal kecuali menambah saldo Anda — menambah dana tetap di dasbor.

Format respons

Setiap respons adalah JSON. Amplop sukses dan error:

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

Endpoint

GET/v1/me

Akun Anda.

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

Saldo akun saat ini (USD).

GET/v1/donors

Situs donor Marketplace (paginasi, 20/halaman). Parameter kueri opsional: 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

Mengembalikan prompt persis yang kami gunakan untuk menulis artikel — sehingga Anda dapat membaca dan mengeditnya. Parameter query opsional: keyword, target_url, language, recommendations. Edit prompt yang dikembalikan dan kirimkan kembali ke POST /v1/orders sebagai recommendations; pertahankan OUTPUT FORMAT blok dan berjalan secara verbatim.

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

Buat pesanan backlink ke keranjang Anda — belum ada biaya. donor_ids selalu diperlukan; kemudian pilih salah satu dari tiga mode konten:

  • Otomotif — kirim target_url + keyword; kami riset & tulis artikelnya.
  • Dari prompt Anda — juga kirim recommendations (ambil & edit prompt dasar melalui GET /v1/article-prompt); kami menulis sesuai brief Anda.
  • Artikel sendiri Anda — kirim content (+ opsional title, article_url); kami memublikasikan HTML Anda yang sudah siap apa adanya. Memerlukan konten sendiri yang diaktifkan di akun Anda.
// 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

Periksa apa yang saat ini ada di keranjang Anda (artikel yang di-draft, donor, harga) sebelum menerbitkan.

POST/v1/basket/pay

Publikasikan semua di keranjang Anda, membayar dari saldo akun Anda. Jika saldo tidak cukup, tidak ada yang dipublikasikan dan mengembalikan success:false dengan berapa banyak lagi yang dibutuhkan. Menambah saldo hanya melalui dasbor.

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

Tautan yang Anda pesan (backlink) dengan status dan URL yang dipublikasikan. /v1/orders (GET) adalah 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" } ] }

Alur pemesanan

  1. Cari situs — GET /v1/donors memilih donor lalu lintas nyata yang relevan.
  2. Pesan — POST /v1/orders dengan id donor dan halaman/kata kunci Anda → item masuk ke keranjang Anda. Pilih mode konten: otomatis, prompt yang Anda edit (recommendationslihat GET /v1/article-prompt), atau milik Anda sendiri content.
  3. Tinjau — GET /v1/basket memeriksa draf dan total.
  4. Publikasikan — POST /v1/basket/pay membayar dari saldo Anda dan menayangkan tautan (~24 jam).
  5. Lacak — GET /v1/links untuk status dan URL yang dipublikasikan.

Kesalahan

  • 401 unauthorized — kunci hilang / tidak valid / dicabut
  • 400 bad_request / payment_failed — body buruk, atau saldo tidak dapat menutupi keranjang
  • 403 forbidden / own_content_disabled — kunci tidak dapat memesan, atau konten sendiri tidak diaktifkan di akun Anda
  • 404 not_found — endpoint atau sumber daya tidak dikenal
  • 405 method_not_allowed
  • 500 server_error — sementara; coba lagi

Untuk agen AI: autentikasi dengan kunci Bearer, panggil GET /v1/me untuk mengonfirmasi akun, GET /v1/donors menemukan situs, lalu POST /v1/orders → POST /v1/basket/pay memesan dan mempublikasikan. Atau lewati HTTP sepenuhnya dan gunakan Server MCP — kunci yang sama, alat bawaan.