BuyLinksForSEO API rehberi

Yayıncı araştırmasını ve geri bağlantı siparişlerini kendi araçlarınıza bağlayın. Bu referans kimlik doğrulama, istek formatları, siparişten yayına iş akışı ve yanıtları kapsar. Entegrasyonlarınız BuyLinksForSEO hesabınızdakiyle aynı bakiyeyi ve siparişleri kullanır.

API anahtarınızı alınYapay zeka ajanı (MCP) bağlayın →

Temel URL ve yetkilendirme

  • Temel URL https://buylinksforseo.com
  • Sürüm öneki /v1
  • Yetki Authorization: Bearer <your_api_key> (veya ?api_key=…)
  • İçerik türü application/json

Kontrol panelinizden anahtar oluşturun ve kopyalayın → API. Bir anahtar bir hesaba aittir ve o hesap üzerinde işlem görür. API, bakiyenizi yüklemek dışında her şeyi yapabilir — bakiye ekleme yalnızca kontrol panelinde kalır.

Yanıt formatı

Her yanıt JSON formatındadır. Başarı ve hata zarfları:

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

Uç Noktalar

GET/v1/me

Hesabınız.

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

Mevcut hesap bakiyesi (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

Makaleyi yazmak için kullandığımız tam istemi döndürür — böylece okuyabilir ve düzenleyebilirsiniz. İsteğe bağlı sorgu parametreleri: keyword, target_url, language, recommendations. Döndürülen istemi düzenleyin ve şuraya iletin: POST /v1/orders seçilen makaleler | Toplam: $ recommendations; OUTPUT FORMAT bloğu çalıştırın ve olduğu gibi çalışır.

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

Sepetinize backlink sipariş(ler)i oluşturun — no charge yet. donor_ids her zaman zorunludur; ardından seçin üç içerik modundan biri:

  • Otomotiv — gönder target_url + keyword; makaleyi araştırıp yazıyoruz.
  • İsteminizden — ayrıca gönder recommendations (taban istemi şu adresten alın ve düzenleyin: GET /v1/article-prompt); sizin briefinize göre yazarız.
  • Kendi makaleniz — gönder content (+ isteğe bağlı title, article_url); hazır HTML'inizi aynen yayınlarız. Hesabınızda kendi içeriğin etkinleştirilmiş olmasını gerektirir.
// 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

Yayınlamadan önce sepetinizde neler olduğunu (hazırlanan makaleler, bağışçı, fiyat) inceleyin.

POST/v1/basket/pay

Sepetinizdeki her şeyi hesap bakiyenizden ödeyerek yayınlayın. Bakiye yetersizse hiçbir şey yayınlamaz ve döner success:false ne kadar daha fazlasının gerektiğini gösterir. Yükleme yalnızca kontrol panelinden yapılır.

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

Sipariş ettiğiniz bağlantılar (backlinkler) durum ve yayınlanan URL ile birlikte. /v1/orders (GET) bir takma addır.

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

Sipariş akışı

  1. Siteleri Bul — GET /v1/donors ilgili, gerçek trafikli bağışçıları seçmek için.
  2. Sipariş — POST /v1/orders bağışçı kimlikleri ve sayfa/anahtar kelimenizle → öğeler sepetinize eklenir. İçerik modunu seçin: otomatik, düzenlenmiş isteminiz (recommendationsşuraya bakın: GET /v1/article-prompt), veya kendi content.
  3. İnceleme — GET /v1/basket taslakları ve toplamı kontrol etmek için.
  4. Yayınla — POST /v1/basket/pay bakiyenizden öder ve linkleri yayına alır (~24 saat).
  5. Takip — GET /v1/links durum ve yayınlanan URL'ler için.

Hatalar

  • 401 unauthorized — eksik / geçersiz / iptal edilmiş anahtar
  • 400 bad_request / payment_failed — kötü gövde veya bakiye sepeti karşılayamıyor
  • 403 forbidden / own_content_disabled — anahtar sipariş veremiyor veya kendi içeriğiniz hesabınızda etkin değil
  • 404 not_found — bilinmeyen uç nokta veya kaynak
  • 405 method_not_allowed
  • 500 server_error — geçici; yeniden deneyin

AI ajanları için: Bearer anahtarıyla kimlik doğrulayın, çağırın GET /v1/me hesabı onaylamak için, GET /v1/donors siteleri bulmak için, ardından POST /v1/orders → POST /v1/basket/pay sipariş etmek ve yayınlamak için. Ya da HTTP'yi tamamen atlayın ve MCP sunucusu — aynı anahtar, yerel araçlar.