الوثائق
مرجع النقاط النهائية والأسعار
عنوان URL واحد، العديد من الإجراءات. هذه هي السطح الكامل.
فريق أبحاث SEOCheck ·

الإجراءات والتكاليف
| الإجراء | الرصيد | ما يعيده |
|---|---|---|
| النطاق | مجاني | سجل أساسي وDR لنطاق واحد |
| نظرة عامة | مجاني | ملخص ملف الروابط الخاص بالنطاق |
| الإحصائيات | مجاني | إحصائيات شاملة للفهرس |
| اقتراح | مجاني | اقتراحات النطاق أثناء الكتابة |
| bulk_dr | 1 | DR لما يصل إلى 2,000 نطاق |
| مقارنة | 1 | مقارنة جنباً إلى جنب لما يصل إلى 20 نطاقاً |
| الأعلى | 1 | أفضل النطاقات |
| dr_distribution | 1 | توزيع DR بين النطاقات المرجعية |
| tld_breakdown | 1 | الروابط حسب النطاق من المستوى الأعلى |
| refdomains | 2 | المجالات المرجعية |
| backlinks | 2 | روابط خلفية فردية |
| anchors | 2 | نصوص ancora |
| toppages | 2 | الصفحات الأكثر ارتباطًا |
| anchor_cloud | 2 | أوزان ancora |
| intersect | 2 | الروابط المشتركة لـ 2 إلى 10 مجالات |
| search | 3 | بحث نصي كامل عبر ancora والعناوين وURLs |
| keyword | 3 | من يتم ربطه بـ ancora دقيق |
الصلاحية والشكل
عنوان URL الأساسي: https://seocheck.dev/api.php?action=<action>&q=<domain>&key=sk_.... تفضل استخدام الرؤوس؟ أرسل Authorization: Bearer sk_... بدلاً من ذلك.
تستجيب واجهة برمجة تطبيقات تحليل backlink هذه بتنسيق JSON وتسمح باستدعاءات عبر الأصل، لذا يمكن للمتصفح الوصول إليها مباشرة. يحتوي كل استجابة على حقل ok. تحتوي الاستجابات المصادق عليها أيضًا على _credits، الذي يحتوي على تكلفة ذلك الاستدعاء والرصيد المتبقي لديك.
الأخطاء مباشرة. يعني HTTP 401 أن المفتاح مفقود أو غير صحيح. يعني HTTP 402 أن الرصيد نفد. كلاهما سهل التعامل معه، ولا يجب إعادة المحاولة في حلقة.
قبل أول استدعاء مدفوع
- قم بتشغيل
overviewعلى مجال تعرفه. إنه مجاني. - تحقق من أن مفتاحك يعمل مع استدعاء واحد بتكلفة 1 مثل
compare. - اقرأ
_creditsفي الاستجابة وتأكد من أن التكلفة تتطابق مع الجدول أعلاه. - قم بتعيين تنبيه نصي لـ HTTP 402 حتى لا يفشل الرصيد الجاف بصمت.
التصفح والترتيب
تصل الصفوف لكل استدعاء إلى 1,000. اطلب عددًا أقل أو أكثر باستخدام per، من 10 إلى 5000، تنقل باستخدام page، ورتب باستخدام sort و order.
curl -s "https://seocheck.dev/api.php?action=backlinks&q=example.com&per=500&page=2&sort=dr&order=desc&key=sk_live_..." | jq '._credits'
المعلمات التي تغير الإجابة
يتخذ كل إجراء الأساسيين نفسهما، action و q، ثم مجموعة قصيرة من الخيارات. اقرأها أولاً. تأتي معظم الأخطاء من خيارات تبدو اختيارية لكنها تغير التكلفة أو شكل الصفوف. اقرأ الخيارات قبل نسخ استدعاء من منتدى أو مدونة.
تفترض الأمثلة أدناه وجود مفتاح في معلمة key. استبدل النص الافتراضي بمفتاحك الخاص. احتفظ بالمفتاح في متغير بيئة، وليس في ملف تقوم بإيداعه. يستخدم كل مثال في مرجع واجهة برمجة تطبيقات تحليل backlink هذا نفس عنوان URL الأساسي.
التصفح باستخدام page و per
تحدد الخيار per عدد الصفوف التي تعود، من 10 حتى 5000. ينقلك الخيار page خلال المجموعة. الاستدعاء الذي يطلب 500 صف ثم page 2 يعيد الكتلة التالية، وليس السحب التالي لنفس الصفوف.
يتوقف التصفح العميق عند 50,000 صف. إذا احتاج العمل إلى أكثر من ذلك، قم بتضييق الاستعلام باستخدام sort أو قسم العمل حسب المجال، بحيث يبقى كل استدعاء ضمن الحد الأقصى.
الترتيب باستخدام sort و order
قم بالترتيب على الخادم، وليس في سكريبتك. طلب sort=dr&order=desc يعيد النطاقات التي تشير إليك الأقوى أولاً، بحيث تظهر الصفوف التي تهمك في الصفحة الأولى. الفلترة بعد تنزيل كامل يضيع الوقت والائتمانات.
استخدم order=asc عندما تريد الصفوف الأضعف، مثلاً للعثور على روابط رقيقة أو لاكتشاف انخفاض مفاجئ في الملف الشخصي.
القوائم: bulk_dr، compare و intersect
تأخذ إجراءات القوائم عدة نطاقات في مكالمة واحدة. يقبل bulk_dr ما يصل إلى 2,000 نطاق مقابل ائتمان واحد، مع سلسلة استعلام GET أو جسم POST. compare يقبل ما يصل إلى 20 نطاقاً، و intersect يقبل من اثنين إلى عشرة.
بما أن السعر لا يعتمد على عدد الصفوف، فإن القائمة الطويلة في مكالمة واحدة أرخص من العديد من المكالمات القصيرة. لنفترض أنك تتحقق من 1,500 موقع مرشح يوم الاثنين. هذه مكالمة واحدة، وليس 1,500.
تكاليف البحث ومكالمات الكلمات المفتاحية أعلى
تعمل عملية search على النص الكامل للنصوص البديلة والعناوين وروابط URL. تطلب عملية keyword معرفة من يتم ربطه بنص بديل دقيق. كلاهما يكلف ثلاثة ائتمانات لكل مكالمة، لذا استخدمهما للإجابة على سؤال محدد بدلاً من التصفح.
اختيار per و page لسحب أولي
للنظرة الأولى على نطاق جديد، ابدأ بـ per صغير، مثل 50. سترى شكل الصفوف وأسماء الحقول والتكلفة في استجابة قصيرة واحدة. ارفع per فقط عندما تتأكد من أن الصفوف هي ما تحتاجه. تعمل هذه العادة نفسها مع كل إجراء في الجدول أعلاه.
خطأ شائع هو طلب 5000 صف في المحاولة الأولى ثم التخلي عن معظمها. الاستجابة أكبر، والانتظار أطول، والادخار الذي كنت تأمل فيه لا يظهر.
قراءة عداد الائتمان
كل استجابة موثقة تنتهي بـ _credits، والذي يعطي تكلفة تلك المكالمة ورصيدك بعدها. سجله. اجمعها في نهاية الشهر وستعرف فاتحتك الحقيقية حتى السنت.
الميزانية التقريبية تساعد. تكلفة ألف مكالمة refdomains هي 2,000 ائتمان، أي $0.20. تكلفة ألف مكالمة search هي 3,000 ائتمان، أو $0.30. تشغيل bulk_dr اليومي على قائمة مكونة من 2,000 نطاق يكلف 1 ائتمان، أي حوالي $0.003 شهرياً.
مقارنة مع الخطط التي تبدأ من $129 شهرياً مقابل 200,000 وحدة API، كما تسردها Ahrefs، فإن شكل الفاتورة مختلف. انظر المقارنة لمعرفة كيف.

قراءة الأخطاء وحقل _credits
يمكن أن يفشل الاستجابة بطريقتين مختلفتين، ويجب أن يعامل كودك كلتاهما بشكل مختلف. هاتان مشكلتان مختلفتان. المفتاح السيء هو مشكلة تكوين. الرصيد الفارغ هو مشكلة فواتير. معالجة كلتاهما كخطأ عام واحد يخفي الإصلاح الذي تحتاجه.
اقرأ حقل ok أولاً. ثم اقرأ كتلة _credits. فقط بعد ذلك يجب أن تنظر إلى الصفوف، لأن النتيجة المفقودة أو القصيرة أسهل في الشرح عندما تعرف بالفعل تكلفة المكالمة.
معالجة 401 و 402 بشكل منفصل
HTTP 401 يعني أن المفتاح مفقود أو خاطئ. أوقف المهمة وأصلح المفتاح. HTTP 402 يعني أن الرصيد مستنفد. قم بإعادة الشحن من صفحة الحساب، ثم واصل. إعادة محاولة 401 لا تفيد أبداً، وإعادة محاولة 402 بدون إعادة شحن لا تفيد أيضاً.
سجل الرصيد قبل وبعد التشغيل
اكتب رصيد _credits في بداية التشغيل وفي نهايته. يجب أن يتطابق الفرق مع ما توقعته من المكالمات التي أجريتها. القفزة الأكبر تعني أن حلقة عملت أكثر مما قصدت.
للتحقق السريع، اضرب عدد المكالمات في تكلفة الائتمان الخاصة بها. إذا كان الجواب 40 وانخفض الرصيد بمقدار 4,000، فهناك خطأ في السكربت، وليس في قائمة الأسعار.
تحقق من الصفوف التي طلبتها
استجابة ناجحة بعدد صفوف أقل من المتوقع ليست خطأ تلقائياً. قد يكون للنطاق الصغير روابط قليلة ببساطة. قارن عدد الصفوف مع قيمة per التي أرسلتها، وعامل الفجوة كسؤال للإجابة عليه، وليس كعيب لإخفائه.
اختبر المكالمات الرخيصة أولاً
قبل توصيل مكالمة بمهمة، شغلها مرة واحدة يدوياً بأصغر الخيارات المعقولة. تحقق من الاستجابة وأسماء الحقول وقيمة _credits. المهمة التي تنكسر في الصف الثاني أصعب في التصحيح من مكالمة فشلت في محاولتها الأولى.
جلسة أولى مع API
أربع مكالمات، بالترتيب، بحيث تكون كل مكالمة لاحقة واحدة تفهمها بالفعل. فقط الأولى مجانية التكلفة، وهذا مقصود.
تشغيل النظرة العامة على نطاق تعرفه
إنها مجانية ولا تحتاج إلى مفتاح. قارن الملخص بما تراه في وحدة تحكم البحث والموقع نفسه، بحيث تعرف كيف تبدو الإجابة الطبيعية.
اختبار المفتاح بمكالمة واحدة بتكلفة 1 ائتمان
أرسل compare مع نطاقك ومنافس واحد. تأكد من أن حقل ok يساوي true وأن _credits يُظهر تكلفة رصيد واحد.
احصل على قائمة بقيمة 2 رصيد مع رسوم صغيرة لكل
اطلب refdomains بـ per=50 و sort=dr. تأكد من مطابقة عدد الصفوف وتكلفة الائتمان للجدول أعلاه.
اكتب التكلفة في سجلك
سجّل الرصيد قبل وبعد. من الآن فصاعدًا، سيبدأ كل سكريبت تكتبه بهذه العادة، ويصبح الفاتورة المفاجلة سطرًا في سجل بدلاً من أن تكون لغزًا.
التسعير
رصيد مدفوع مسبقًا. الرصيد الواحد يساوي $0.0001. لا يوجد اشتراك ولا حد أدنى شهري.
ادفع حسب الاستخدام
$0.10لكل 1,000 طلب يتطلب رصيدًا واحدًا
- $100 رصيد مجاني عند التسجيل
- لا حاجة لبطاقة
- إضافة رصيد عبر USDT (TRC-20)
- يُفوتَر مرة واحدة لكل استدعاء، وليس لكل صف
حدود يجب أن تكون على علم بها
تغطي الفهرسة 181,132,097 نطاقاً و2,774,625,913 رابطاً نطاقياً. يتم التحديث تقريباً شهرياً، وهو أبطأ من الزحف اليومي.
يتوقف التصفح العميق عند 50,000 صف. للعمليات الأكبر، أضف تقييداً للاستعلام باستخدام sort أو قسّم النتائج حسب النطاق.
تسجيل الدخول متاح عبر Google فقط، والإضافات تتم بـ USDT. ابدأ بـ فحص DR، أو جرّب تدقيق المنافسين عبر دليل القوة التنافسية، أو اقرأ لماذا تتخلى بعض الفرق عن Ahrefs API لأعمال الروابط البحتة.
الأسئلة الشائعة
هل أدفع مقابل كل صف؟
لا. يُفوتَر الاستدعاء مرة واحدة، سواء أكانت النتيجة 10 صفوف أو 1,000.
ماذا يحدث عند نفاد الرصيد؟
يعيد الـ API رمز HTTP 402. قم بإضافة رصيد عبر USDT (TRC-20) من صفحة الحساب واستمر.
أين أجد مفتاح الـ API الخاص بي؟
في لوحة التحكم بعد تسجيل الدخول عبر Google.