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": "…" } }एंडपॉइंट्स
/v1/meआपका खाता।
{ "success": true, "data": { "id": 123, "email": "[email protected]", "name": "You", "balance": 45.00 } }/v1/balanceवर्तमान खाता शेष (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-promptलेख लिखने के लिए हम ज़रूरी प्रॉम्प्ट लौटाता है — ताकि आप उसे पढ़कर संपादित कर सकें। वैकल्पिक क्वेरी पैरामीटर: keyword, target_url, language, recommendations. लौटाए गए प्रॉम्प्ट को एडिट करें और इसे वापस पास करें POST /v1/orders जैसा recommendations; रखें OUTPUT FORMAT ब्लॉक करें और यह वैसे ही चलता है।
{ "success": true, "data": { "default_prompt": "…", "editable_field": "recommendations",
"modes": { "own": "…", "prompt": "…", "auto": "…" } } }/v1/ordersअपनी basket में backlink ऑर्डर बनाएँ — अभी कोई शुल्क नहीं. donor_ids हमेशा आवश्यक है; फिर चुनें तीन कंटेंट मोड में से एक:
- ऑटो — भेजें
target_url+keyword; हम लेख पर रिसर्च करते हैं और उसे लिखते हैं। - आपके प्रॉम्प्ट से — भी भेजें
recommendations(बेस प्रॉम्प्ट को फ़ेच और एडिट करेंGET /v1/article-prompt) के लिए हम आपके ब्रीफ के अनुसार लिखते हैं। - आपका स्वयं का लेख — भेजें
content(+ optionaltitle,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" } }/v1/basketप्रकाशित करने से पहले देखें कि आपकी बास्केट में वर्तमान में क्या है (ड्राफ्ट किए गए लेख, दाता, मूल्य)।
/v1/basket/payअपनी टोकरी में सब कुछ प्रकाशित करें, अपने खाते की शेष राशि से भुगतान करें। यदि शेष राशि कम है तो यह कुछ भी प्रकाशित नहीं करता है और लौटाता है success:false कितनी और आवश्यकता है इसके साथ। टॉप अप केवल डैशबोर्ड में ही होता है।
{ "success": true, "data": { "status": "published", "charged": 24, "links": 2 } }/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" } ] }ऑर्डरिंग प्रवाह
- साइटें खोजें —
GET /v1/donorsप्रासंगिक, वास्तविक-ट्रैफिक दाताओं को चुनने के लिए। - क्रम —
POST /v1/ordersदाता ids और आपके पेज/कीवर्ड के साथ → आइटम आपकी basket में आ जाते हैं। सामग्री मोड चुनें: ऑटो, आपका संपादित प्रॉम्प्ट (recommendations, देखेंGET /v1/article-prompt), या आपका अपनाcontent. - समीक्षा —
GET /v1/basketड्राफ़्ट और कुल देखने के लिए। - प्रकाशित करें —
POST /v1/basket/payआपके बैलेंस से भुगतान करता है और लिंक्स को लाइव पुश करता है (~24 घंटे)। - ट्रैक —
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 सर्वर — वही कुंजी, देशी टूल।