संदर्भ
बैकलिंक्स API संदर्भ: एक्शन, लागत और त्रुटियाँ
मॉनिटर को आवश्यक तथ्यों के लिए एक पेज: प्रत्येक एक्शन की लागत, पेजिनेशन कैसे काम करती है, और जब कुछ गलत हो जाए तो API क्या करती है।

क्रेडिट लागत के अनुसार एक्शन
| लागत | एक्शन | नोट्स |
|---|---|---|
| मुफ्त, कोई कुंजी नहीं | domain, overview, stats, suggest | डैशबोर्ड और DR चेकर के लिए उपयुक्त |
| 1 क्रेडिट | bulk_dr, compare, top, dr_distribution, tld_breakdown | bulk_dr अधिकतम 2,000 डोमेन्स लेता है (GET domains= या POST बॉडी); compare अधिकतम 20 |
| 2 क्रेडिट | refdomains, backlinks, anchors, toppages, anchor_cloud, intersect | intersect 2 से 10 डोमेन्स लेता है |
| 3 क्रेडिट | search, keyword | एंकर, शीर्षकों और URL पर पूर्ण-पाठ खोज; keyword पाता है कि किसने एक सटीक एंकर के साथ लिंक किया है |
प्रमाणीकरण और स्टेटस कोड
कुंजी को key= के रूप में या बेयरर हेडर के रूप में पास करें। बॉडी को पार्स करने से पहले HTTP कोड की जाँच करें।
# header style
curl -s -H "Authorization: Bearer sk_live_..." \
"https://seouptr.com/api.php?action=anchors&q=yourdomain.com&per=100"
# a cron-safe wrapper
code=$(curl -s -o out.json -w '%{http_code}' "$URL")
case "$code" in
200) jq '._credits' out.json ;; # cost and remaining balance
401) echo 'bad or missing key' ;;
402) echo 'out of credit: top up' ;;
*) echo "unexpected $code" ;;
esacपैरामीटर और त्रुटियाँ
| आइटम | मूल्य | अर्थ |
|---|---|---|
q | एक डोमेन | खोज का लक्ष्य |
page, per | per 10 से 5000 तक | पेजिनेशन; प्रति कॉल पंक्तियाँ 1,000 तक सीमित हैं, गहरी पेजिनेशन 50,000 तक |
sort, order | order=asc या desc | वापस की गई पंक्तियों का सॉर्टिंग |
ok | प्रत्येक प्रतिक्रिया में | क्या कॉल सफल हुई |
_credits | केवल प्रमाणीकृत प्रतिक्रियाओं में | कॉल की लागत और शेष बैलेंस |
| HTTP 401 | कुंजी गायब या खराब | कुंजी या हेडर की जाँच करें |
| HTTP 402 | क्रेडिट समाप्त | USDT (TRC-20) के साथ टॉप अप करें |

पहले से कॉल की डिज़ाइन करना
अधिकांश API समस्याएँ अनुरोध में शुरू होती हैं। प्रतिक्रिया में नहीं। एक seo backlinks api इंटीग्रेशन मुख्य रूप से पहले कॉल से पहले की गई छोटी-छोटी निर्णयों का सेट है। कुंजी, पेज साइज और सॉर्ट ऑर्डर पहले तय करें।
कुंजी को स्क्रिप्ट से बाहर रखें
कुंजी को एक एनवायरनमेंट वेरिएबल या सीक्रेट स्टोर में स्टोर करें, उस फ़ाइल में नहीं जिसे आप कमीट करते हैं। इसे key पैरामीटर या बेयरर हेडर के रूप में पास करें। हेडर कुंजी को उन एड्रेस से बाहर रखता है जो अक्सर लॉग में आते हैं।
लाइव कुंजी को टिकट या चैट में पेस्ट न करें। एक कुंजी को जो साझा लॉग में दिखाई देती है, उसे एक्सपोज़ मानें।
पेज साइज को जानबूझकर चुनें
per पैरामीटर 10 से 5000 तक चलता है, लेकिन एक कॉल को 1,000 पंक्तियाँ तक के लिए एक बार बिल किया जाता है, इसलिए बड़ी पेज का मतलब कम चार्ज। मान लीजिए आपको 3,400 पंक्तियाँ चाहिए। इसके लिए 1,000 पंक्तियों के साथ चार कॉल की आवश्यकता होगी, न कि 10 पंक्तियों के साथ 340 कॉल।
रन के दौरान पेज साइज को समान रखें ताकि फ़ाइलें लाइन में रहें।
सॉर्ट ऑर्डर को स्थिर रखें
sort और order को स्पष्ट रूप से सेट करें, डिफ़ॉल्ट पर भरोसा करने के बजाय। समान पैरामीटर से आउटपुट सप्ताह से सप्ताह तुलनीय रहता है, इसलिए diff में असली बदलाव दिखता है, रीशफल किए गए पंक्तियाँ नहीं।
क्रम में बदलाव एक झूठी अलार्म बनाने का आसान तरीका है।
संख्याओं को पढ़ना
डेटा हमारा अपना लिंक ग्राफ़ है: 181,132,097 डोमेन, 2,774,625,913 डोमेन-से-डोमेन लिंक और लगभग 798.5 बिलियन बैकलिंक्स। यह मासिक आधार पर अपडेट होता है। इसमें उससे नया डेटा नहीं होगा, इसलिए एक seo backlinks api को साप्ताहिक रूप से पोल करना सर्वोत्तम है।
DR round(100 · log(ref_domains+1) / log(2·10^7)) है। यह एक लॉग है। इसी कारण, 100 रिफ़रिंग डोमेन का स्कोर 27, 1,000 का स्कोर 41 और 10,000 का स्कोर 55 होता है, इसलिए लिंक काउंट दोगुना करने से केवल कुछ ही अंक जुड़ते हैं। साइट्स को एक-दूसरे के सापेक्ष रैंक करने के लिए DR का उपयोग करें और अलर्ट के लिए रॉ काउंट, जैसा कि severity table करता है।
मूल्य पूर्व-भुगतान पर आधारित है। कोई सब्सक्रिप्शन या न्यूनतम राशि नहीं है। साइन-अप क्रेडिट $100 है, जो 1,000,000 क्रेडिट के बराबर है। Ahrefs API यूनिट्स की तुलना करें, जो $129/माह की प्लान से शुरू होती हैं और 200,000 यूनिट्स देती हैं, जहाँ प्रत्येक अनुरोध में कम से कम 50 यूनिट होती हैं।
लागत की योजना सरल गुणा है। एक साइट के लिए साप्ताहिक refdomains कॉल 2 क्रेडिट्स की है, या महीने में 4 बार, यानी महीने में 8 क्रेडिट्स, जो $0.0008 है। दस साइट्स की लागत दस गुना होगी। lost-link recipe और competitor job दोनों ऊपर दी गई तालिका के एक्शन का ही उपयोग करते हैं।
अंदाजा लगाए बिना एरर को पढ़ना
एरर कोड आपको बताता है कि किसें एक्शन लेना है। इसे उसी नज़रिए से पढ़ें। तब रिस्पॉन्स एक राउटिंग निर्णय बन जाता है, रहस्य नहीं। मॉनिटर के लिए सबसे महत्वपूर्ण दो कोड 401 और 402 हैं।
401 और 402 अलग-अलग समस्याएं हैं
401 का मतलब है कि कुंजी गायब है या गलत है, और कोई भी कॉल तब तक सफल नहीं होगी जब तक कोई इसे ठीक न करे। 402 का मतलब है कि खाते में क्रेडिट खत्म हो गए हैं, और टॉप-अप इसे हल कर देता है। उन्हें अलग-अलग मालिकों को राउट करें ताकि सही व्यक्ति संदेश देखे।
दोनों को एक व्यक्ति को भेजें। एक मॉनिटर जो चुपचाप फेल हो जाए, उससे बेहतर है जो कभी चला ही न हो।
बॉडी से पहले स्टेटस चेक करें
HTTP स्टेटस पहले पढ़ें और ok फ़ील्ड दूसरे। एक रिस्पॉन्स JSON के रूप में पार्स हो सकता है और फिर भी फेलियर ले सकता है, इसलिए चेक तब तक पूर्ण नहीं होता जब तक दोनों पास न हो जाएं। हर रन के साथ स्टेटस को लॉग करें, सफल रनों सहित।
केवल उन चीज़ों को रीट्राई करें जो रिकवर हो सकती हैं
401 को रीट्राई करने से कॉल बर्बाद होती हैं और लॉग समान फेलियर से भर जाते हैं। नेटवर्क टाइमआउट अलग बात है। इसे कुछ बार रीट्राई करें, प्रयासों के बीच विराम दें, फिर रुक जाएं।
एक रन जो रुकता है और अलार्म देता है, वह एक रीट्राई लूप से अधिक उपयोगी है जो बैलेंस खत्म होने तक फेलियर छुपा देता है।
हर रन पर स्टेटस लॉग करें
हर रन पर HTTP स्टेटस और बैलेंस को लॉग में लिखें, सफल रनों सहित। जब एक रन तीन सप्ताह बाद फेल होता है, तो वह लाइन वह पहली चीज़ होगी जिसे आप देखना चाहेंगे।
domain, overview, stats और suggest को कुंजी की आवश्यकता नहीं है और इनकी कोई लागत नहीं है। इन्हें किसी पेड एक्शन पर एक क्रेडिट खर्च करने से पहले डोमेन नाम, सटीक वर्तनी या अनुमानित आकार की सत्यापन के लिए उपयोग करें।
कॉल को क्रॉन में डालने से पहले
- एक्शन की लागत ज्ञात है और इसे मासिक रनों से गुणा करें।
- एग्जिट कोड और HTTP स्टेटस दोनों चेक किए जाते हैं।
- 402 एक इंसान को अलर्ट भेजता है।
- रिस्पॉन्स को सॉर्ट करके सेव किया जाता है, ताकि diff साफ़ रहें।
- कैडेंस मासिक रिफ़्रेश से मेल खाता है।

पेजिनेशन पर नोट्स
क्रम महत्वपूर्ण है। सनैपशॉट्स के लिए per=1000 का उपयोग करें और हर सप्ताह समान sort और order रखें। यदि रनों के बीच क्रम बदल जाता है, तो diff में शोर दिखता है। यह झूठी अलार्म का एक क्लासिक कारण है।
बड़ी साइटें? 1,000 से अधिक रिफ़रिंग डोमेन वाली साइट के लिए, page=1, page=2 आदि के साथ पेज करें। प्रत्येक पेज एक अलग बिलिंग कॉल है। डीप पेजिनेशन 50,000 पंक्तियों तक सीमित है, जो लगभग हर सामान्य साइट को कवर करता है।
रेफ़रेंस से संबंधित प्रश्न
- जब मुझे यह नहीं पता कि एक डोमेन कैसा दिखता है, तो मुझे पहले कौन सा एक्शन कॉल करना चाहिए?
overviewयाdomainसे शुरू करें। दोनों फ्री हैं और कुंजी की आवश्यकता नहीं है, और ये डेटा का अनुमानित आकार और बुनियादी संरचना दिखाते हैं। उसके बाद हीrefdomainsयाanchorsपर क्रेडिट खर्च करें।- एक डोमेन की पूर्ण जाँच की लागत कितनी है?
- प्रत्येक एक्शन के क्रेडिट्स को जोड़ें, फिर इसे बार-बार चलने की संख्या से गुणा करें। एक
refdomainsकॉल, एकanchorsकॉल और एकtld_breakdownकॉल की कल्पना करें, एक डोमेन पर साप्ताहिक। यह एक रन में 2 + 2 + 1 = 5 क्रेडिट्स है, या $0.0005। चार सप्ताह में यह लगभग $0.002 आता है। - एक ही डोमेन के लिए दो काउंट मिलान क्यों नहीं कर सकते?
- समान चीज़ की तुलना करें: समान एक्शन, समान पैरामीटर और समान रिफ़्रेश अवधि। अलग-अलग एक्शन से लिए गए काउंट अदला-बदली योग्य नहीं हैं, और रिफ़्रेश के बीच में लिया गया काउंट एक सप्ताह बाद वाले काउंट से भिन्न हो सकता है।
- मैं क्रेडिट खर्च किए बिना क्रॉन जॉब का परीक्षण कैसे करूं?
- वायरिंग, स्टेटस हैंडलिंग और आउटपुट फॉर्मेट चेक करने के लिए पहले फ्री एक्शन चलाएं। फिर नंबर साबित करने के लिए एक पेड कॉल करें, और परीक्षण के दौरान जॉब को एक ही रन तक सीमित रखें।
- क्या 1,000 से अधिक रिफ़रिंग डोमेन वाली साइट के लिए पेजिंग काम करती है?
- हाँ।
perके साथpageका उपयोग करें। प्रत्येक पेज एक अलग बिलिंग कॉल है, और डीप पेजिनेशन 50,000 पंक्तियों तक सीमित है, जो अधिकांश सामान्य साइटों को कवर करता है।
एक बुरे सप्ताह से टिक जाने वाला मॉनिटर
जब कुछ भी ठीक न हो, तब मॉनिटर भरोसा अर्जित करता है। पहले रन से पहले धीमे रिस्पॉन्स, बदले हुए बैलेंस और आंशिक परिणाम की योजना बनाएं। ये सामान्य घटनाएं हैं। प्रत्येक को लॉग में एक स्पष्ट लाइन छोड़नी चाहिए।
टाइमआउट और आंशिक डेटा खींचना
हर कॉल पर टाइमआउट सेट करें, ताकि एक धीमा रिस्पॉन्स पूरी जॉब को न रोक सके। यदि मल्टी-पेज पुल में एक पेज फेल होता है, तो रिकॉर्ड करें कि वह कौन सा पेज था और वहां से फिर से शुरू करें। इससे आपको पहले से मौजूद पंक्तियों के लिए दो बार भुगतान करने से बचाया जा सकता है।
आंशिक फ़ाइल को आंशिक के रूप में चिह्नित करें, सामान्य सनैपशॉट के रूप में सेव न करें। वरना अगला diff एक ऐसी हानि दिखाएगा जो कभी हुई ही नहीं।
बैलेंस चेक
प्रत्येक ऑथेंटिकेटेड रिस्पॉन्स पर _credits पढ़ें और शेष बैलेंस को लॉग में लिखें। एक छोटा स्क्रिप्ट इसे आपके द्वारा चुने गए फ्लोर से तुलना कर सकता है और अगले रन से पहले चेतावनी भेज सकता है।
मान लें कि फ्लोर 500 क्रेडिट्स है। एक साप्ताहिक रन जो 40 क्रेडिट्स खर्च करता है, रात के बीच में 402 आने से पहले टॉप-अप करने के लिए जगह छोड़ देता है।
हर जॉब को साधारण रखें
प्रत्येक जॉब को एक फ़ाइल और एक शेड्यूल दें। एक क्रॉन एंट्री जो तीन काम करती है, तीन तरीकों से फेल हो सकती है, और लॉग हमेशा यह नहीं बता सकता कि कौन सा काम हुआ। दो छोटी जॉब्स एक होशियार जॉब से अधिक भरोसेमंद होती हैं।
शेड्यूल को रिफ़्रेश से मिलाएं
जॉब के शेड्यूल को घड़ी से नहीं, बल्कि मासिक रिफ़्रेश से मिलाएं। एक दैनिक रन अधिकांश दिनों में समान फ़ाइल देता है, जिससे लागत और शोर बढ़ता है लेकिन जानकारी नहीं मिलती। साप्ताहिक आमतौर पर पर्याप्त है।