تخطي إلى المحتوى
SEOCheck
SEOCheckإنشاء حساب

الوثائق

مرجع النقاط النهائية والأسعار

عنوان URL واحد، العديد من الإجراءات. هذه هي السطح الكامل.

فريق أبحاث SEOCheck ·

جسر حجري متين يعبر وادياً ضبابياً، يرمز إلى نقطة نهاية API موثوقة

الإجراءات والتكاليف

الإجراءالرصيدما يعيده
النطاقمجانيسجل أساسي وDR لنطاق واحد
نظرة عامةمجانيملخص ملف الروابط الخاص بالنطاق
الإحصائياتمجانيإحصائيات شاملة للفهرس
اقتراحمجانياقتراحات النطاق أثناء الكتابة
bulk_dr1DR لما يصل إلى 2,000 نطاق
مقارنة1مقارنة جنباً إلى جنب لما يصل إلى 20 نطاقاً
الأعلى1أفضل النطاقات
dr_distribution1توزيع DR بين النطاقات المرجعية
tld_breakdown1الروابط حسب النطاق من المستوى الأعلى
refdomains2المجالات المرجعية
backlinks2روابط خلفية فردية
anchors2نصوص ancora
toppages2الصفحات الأكثر ارتباطًا
anchor_cloud2أوزان ancora
intersect2الروابط المشتركة لـ 2 إلى 10 مجالات
search3بحث نصي كامل عبر ancora والعناوين وURLs
keyword3من يتم ربطه بـ 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.

bash
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

أربع مكالمات، بالترتيب، بحيث تكون كل مكالمة لاحقة واحدة تفهمها بالفعل. فقط الأولى مجانية التكلفة، وهذا مقصود.

01

تشغيل النظرة العامة على نطاق تعرفه

إنها مجانية ولا تحتاج إلى مفتاح. قارن الملخص بما تراه في وحدة تحكم البحث والموقع نفسه، بحيث تعرف كيف تبدو الإجابة الطبيعية.

02

اختبار المفتاح بمكالمة واحدة بتكلفة 1 ائتمان

أرسل compare مع نطاقك ومنافس واحد. تأكد من أن حقل ok يساوي true وأن _credits يُظهر تكلفة رصيد واحد.

03

احصل على قائمة بقيمة 2 رصيد مع رسوم صغيرة لكل

اطلب refdomains بـ per=50 و sort=dr. تأكد من مطابقة عدد الصفوف وتكلفة الائتمان للجدول أعلاه.

04

اكتب التكلفة في سجلك

سجّل الرصيد قبل وبعد. من الآن فصاعدًا، سيبدأ كل سكريبت تكتبه بهذه العادة، ويصبح الفاتورة المفاجلة سطرًا في سجل بدلاً من أن تكون لغزًا.

التسعير

رصيد مدفوع مسبقًا. الرصيد الواحد يساوي $0.0001. لا يوجد اشتراك ولا حد أدنى شهري.

إجراءات مجانية

$0

  • النطاق، نظرة عامة، إحصائيات، اقتراح
  • لا حاجة لمفتاح
  • يُشغّل فاحص النطاقات
افتح الفاحص

ادفع حسب الاستخدام

$0.10لكل 1,000 طلب يتطلب رصيدًا واحدًا

  • $100 رصيد مجاني عند التسجيل
  • لا حاجة لبطاقة
  • إضافة رصيد عبر USDT (TRC-20)
  • يُفوتَر مرة واحدة لكل استدعاء، وليس لكل صف
احصل على $100 مجاناً

حدود يجب أن تكون على علم بها

تغطي الفهرسة 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.