BuyLinksForSEO API गाइड

प्रकाशक रिसर्च और बैकलिंक ऑर्डर को अपने स्वयं के टूल्स से कनेक्ट करें। यह संदर्भ प्रमाणीकरण, अनुरोध प्रारूप, ऑर्डर-से-प्रकाशन वर्कफ़्लो और प्रतिक्रियाओं को कवर करता है। आपके एकीकरण आपके BuyLinksForSEO खाते के समान बैलेंस और ऑर्डर का उपयोग करते हैं।

बेस URL और प्रमाणीकरण

  • बेस URL https://buylinksforseo.com
  • संस्करण प्रीफ़िक्स /v1
  • ऑथ Authorization: Bearer <your_api_key> (या ?api_key=…)
  • कंटेंट का प्रकार application/json

अपने डैशबोर्ड में कुंजी बनाएँ और कॉपी करें → API. एक कुंजी एक खाते से संबंधित होती है और उसी खाते पर कार्य करती है। API आपका बैलेंस टॉप अप करने को छोड़कर सब कुछ कर सकता है — डैशबोर्ड में धन जोड़ना रहता है.

रिस्पॉन्स फ़ॉर्मेट

हर रिस्पॉन्स JSON है। सफलता और त्रुटि एनवलप:

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

एंडपॉइंट्स

GET/v1/me

आपका खाता।

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

वर्तमान खाता शेष (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

लेख लिखने के लिए हम ज़रूरी प्रॉम्प्ट लौटाता है — ताकि आप उसे पढ़कर संपादित कर सकें। वैकल्पिक क्वेरी पैरामीटर: keyword, target_url, language, recommendations. लौटाए गए प्रॉम्प्ट को एडिट करें और इसे वापस पास करें POST /v1/orders जैसा recommendations; रखें OUTPUT FORMAT ब्लॉक करें और यह वैसे ही चलता है।

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

अपनी basket में backlink ऑर्डर बनाएँ — अभी कोई शुल्क नहीं. donor_ids हमेशा आवश्‍यक है; फिर चुनें तीन कंटेंट मोड में से एक:

  • ऑटो — भेजें target_url + keyword; हम लेख पर रिसर्च करते हैं और उसे लिखते हैं।
  • आपके प्रॉम्प्ट से — भी भेजें recommendations (बेस प्रॉम्प्ट को फ़ेच और एडिट करें GET /v1/article-prompt) के लिए हम आपके ब्रीफ के अनुसार लिखते हैं।
  • आपका स्वयं का लेख — भेजें content (+ optional 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 दाता ids और आपके पेज/कीवर्ड के साथ → आइटम आपकी basket में आ जाते हैं। सामग्री मोड चुनें: ऑटो, आपका संपादित प्रॉम्प्ट (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 — खराब body, या basket को बैलेंस कवर नहीं कर सकता
  • 403 forbidden / own_content_disabled — कुंजी ऑर्डर नहीं कर सकती, या आपके खाते पर own-content सक्षम नहीं है
  • 404 not_found — अज्ञात endpoint या संसाधन
  • 405 method_not_allowed
  • 500 server_error — क्षणिक; पुनः प्रयास करें

AI एजेंट्स के लिए: Bearer key से प्रमाणीकरण करें, कॉल करें GET /v1/me खाता पुष्टि करने के लिए, GET /v1/donors साइटें खोजने के लिए, फिर POST /v1/orders → POST /v1/basket/pay ऑर्डर और प्रकाशित करने के लिए। या HTTP को पूरी तरह छोड़ दें और उपयोग करें MCP सर्वर — वही कुंजी, देशी टूल।