مرجع
تقرير الروابط الخلفية من Ahrefs مقابل مخرجات الـ API: مرجع للإجراءات
إذا كنت معتاداً على تصدير تقرير روابط خلفية من Ahrefs، فإن هذا المرجع يوضح الأجزاء التي يمكنك إعادة بنائها من خلال إجراءاتنا، تكلفة كل استدعاء، وأين تتفوق الحزم الكبيرة.
الإجراءات، الأسعار وما تحل محله في التقرير
| الإجراء | الاعتمادات | الجزء الأقرب في تقرير نموذجي | ملاحظات |
|---|---|---|---|
| domain, overview, stats, suggest | 0 | عدود العناوين الفرعية | لا يتطلب مفتاحاً |
| bulk_dr | 1 | عمود DR لقائمة | حتى 2000 نطاق في كل استدعاء |
| compare | 1 | مقارنة النطاقات جنباً إلى جنب | حتى 20 نطاقاً |
| top, dr_distribution, tld_breakdown | 1 | مخططات الملخص | ملخصات على شكل توزيع |
| refdomains | 2 | علامة النطاقات المرجعية | مدفوع |
| backlinks | 2 | علامة الروابط الخلفية | مدفوع |
| anchors, anchor_cloud | 2 | علامة النصوص الوصفية | السحابة مخصصة للعرض |
| الصفحات العليا | 2 | الأفضل حسب الروابط | الصفحات التي تجذب الروابط |
| التقاطع | 2 | تقاطع الروابط | من 2 إلى 10 نطاقات |
| البحث، الكلمة المفتاحية | 3 | لا يوجد تطابق مباشر | البحث في النص المرسِل، العنوان وURL |
كيف تتوافق علامات التبويب في التقرير مع إجراءاتنا
تأتي معظم تصديرات التقرير على شكل علامات تبويب، ولكل علامة تبويب ما يقابلها تقريباً هنا. ليست نسخة مطابقة تماماً. اقرأ خريطة التوافق كنقطة بداية، لأن حقلًا موجودًا في علامة تبويب واحدة قد لا يكون موجودًا في استجابتنا على الإطلاق.
علامة التبويب الخاصة بالنطاقات المرجعية
تخيل تقريرًا يفتح على النطاقات المرجعية المرتبة حسب DR. أقرب خيار لدينا هو refdomains، بتكلفة 2 رصيد، ويمكن ترتيبه بنفس الطريقة. توقع إعادة تسمية عمود أو اثنين في نصك البرمجي، لأن أسماء حقول الصفوف تختلف حسب الإجراء.
ثبّت الترتيب بين الأشهر. لا يمكن مقارنة قائمة مرتبة حسب DR في شهر واحد ومرتبة حسب الزيارات في الشهر التالي بشكل صادق، لذا اكتب مفتاح الترتيب في اسم الملف.
علامة التبويب الخاصة بالنصوص المرسلة، ولماذا السحابة مخصصة للعرض
anchors هو الأمر الخاص بعلامة التبويب للنصوص المرسلة، بتكلفة 2 رصيد. يكلف anchor_cloud المبلغ نفسه، ولكن كما يشير الجدول أعلاه، فهو مخصص للعرض. إذا كان القرار يعتمد على الأرقام، اقرأ القائمة النصية العادية.
اقرأ النصوص المرسلة بسؤال واحد: هل سيكتب كاتب حقيقي هذه الكلمات؟ عادةً ما تمر أسماء العلامات التجارية وURLs المجردة. كتلة من عبارات المال المتطابقة المتكررة عبر نطاقات عديدة لا تمر، وهذه الكتلة هي الجزء الذي يجب فحصه أولاً.
الصفحات الأعلى ومنظور النطاقات من اثنين إلى عشرة
toppages هو الأقرب إلى علامة التبويب للأفضل حسب الروابط. يُظهر أي الصفحات تجذب الروابط، وهذا غالباً ما يقول أكثر من إجمالي النطاق عندما يؤثر تغيير في الترتيب على مجلد واحد من الموقع.
intersect يأخذ بين اثنين وعشرة نطاقات ويكلف 2 رصيد لكل استدعاء. قل أنك تقارن موقعك بمنافسين اثنين. سيظهر التداخل حينها أي مواقع الروابط المشتركة بينكم الثلاثة، وهو أمر بسيط ورخيص.
المعاملات التي تنطبق عبر الاستدعاءات
ثلاثة أشياء تتحكم في كل قائمة. وهي page وper والزوج sort مع order. ثبّتها بين الأشهر.
يقبل per القيم من 10 إلى 5000، رغم أن كل استدعاء يعيد ما يصل إلى 1000 صف، وتتوقف التصفح العميق عند 50,000 صف. يُفوت كل استدعاء مرة واحدة بغض النظر عن عدد الصفوف، لذا فإن طلب صفحة كاملة يكلف نفس تكلفة طلب عشرة صفوف.
المصادقة تأخذ إما key=sk_... في الاستعلام أو رأس Authorization: Bearer sk_.... CORS مفتوح، ولكن احتفظ بالمفتاح على خادمك على أي حال، لأن كود المتصفح يعرضه لكل زائر.
الترتيب مهم. عند التصفح عبر النتائج، رتب حسب DR تنازلياً للنطاقات التي على الأرجح تهمك، أو تصاعدياً لفحص الذيل الطويل للمواقع الصغيرة. أياً كان ما تختاره، اكتبه بجانب الملف.
عامل الجدول أعلاه كخريطة والاستجابات المحفوظة كإقليم. إذا كان حقل كنت تتوقعه غائباً، ابنِ حول ما هو موجود.
تصدير شهري، في خمس خطوات
نفذ الخطوات الخمس نفسها كل شهر، بحيث تتطابق الملفات المحفوظة عند مقارنتها.
- 1
اختر الاستدعاءات
اختر
refdomainsوanchorsوtoppagesلكل نطاق. نظرة عامة والإحصائيات مجانية، لذا أضفها إلى نفس المجلد. - 2
ثبّت العمق
ضبط
pageوperوsortوorderمرة واحدة وثبّتها. يمكن أن يصل per إلى 5000، لكن كل استدعاء فردي يعيد ما يصل إلى 1000 صف. - 3
احفظ كل استجابة كما هي
اكتب الـ JSON الخام إلى القرص قبل أي عملية تحليل. إذا فشل سكريبت لاحقًا، فإن النسخة المحفوظة هي التي ستعيد تشغيلها.
- 4
اقرأ كائن _credits
تُبلغ كل استجابة مُصادق عليها بتكلفتها والرصيد المتبقي. انسخ كلاهما إلى سطر سجل، بحيث تكون نفقات الشهر مرئية بدون لوحة تحكم.
- 5
مقارنة مع الشهر الماضي
قارن بين النسخ المحفوظة. يوضح وصفة الاختلاف الأعمدة الثلاثة التي تستحق الاحتفاظ بها.
الائتمانات، حدود الصفوف وفاتورة الشهر
قائمة الأسعار قصيرة. تعتمد الفاتورة على وتيرة استخدامك للواجهة وكيفية تقسيم البيانات إلى صفحات. ثلاثة عادات تحدد معظم التكلفة.
فاتورة واحدة لكل استدعاء، بغض النظر عن عدد الصفوف
يتم احتساب كل استدعاء مرة واحدة، لذا فإن per=1000 يكلف نفس مبلغ per=10 لنفس الإجراء. الصفحة الكاملة هي الخيار الرخيص لقائمة ستعيد استخدامها، وهي خيار مُهدر للنظرة السريعة.
لنفترض أنك تسحب refdomains لنطاق واحد في نفس اليوم من كل شهر. هذا يعني 2 رصيد، أو $0.0002، شهرياً بسعر النشر البالغ $0.0001 لكل رصيد.
حد الـ 50,000 صف
يتوقف التصفح العميق عند 50,000 صف. الحلقة التي تستمر في طلب الصفحة التالية بعد ذلك لن تحصل على أي بيانات جديدة، لذا قم بتحديد عدد الصفحات قبل بدء الحلقة.
الوصول إلى الحد الأقصى بـ 1,000 صف لكل استدعاء يتطلب خمسين استدعاءً. بمبلغ 2 رصيد لكل استدعاء، يصبح المجموع 100 رصيد، أو $0.01. رخيص، ولكن فقط إذا توقفت الحلقة عند الوقت المناسب.
ميزانية صغيرة لعادة شهرية
تخيل عشرة نطاقات، يتم سحب refdomains و anchors لها مرة واحدة شهرياً. هذا يعني 40 رصيداً شهرياً، أو $0.004، تُخصم من رصيد الـ $100 المجاني عند التسجيل، والذي يعادل 1,000,000 رصيد.
بوتيرة هذا النوع، تستمر الرصيد المجاني لفترة طويلة، ويسجل السجل الإنفاقية ما إذا كانت هذه الوتيرة مستمرة. حافظ عليها.
استكشاف الأخطاء وإصلاحها في الاستجابات
| تلاحظ | السبب | الحل |
|---|---|---|
| HTTP 401 | المفتاح مفقود أو غير صحيح | تحقق من المفتاح وكتابة العنوان (header) |
| HTTP 402 | نفدت الرصيد | أضف رصيدًا عبر USDT (TRC-20) من صفحة الحساب |
| ok is false | تم رفض الطلب | اقرأ الرسالة في الجسم والمعاملات التي أرسلتها |
| عدد أقل من الصفوف مما تظهره المجموعة الكبيرة | توقيت فهرسة و crawling مختلف | قارن الاتجاهات، لا الإجماليات |
| رابط أنشأته الأسبوع الماضي مفقود | إعادة بناء الفهرس شهرياً تقريباً | تحقق مرة أخرى في الدورة القادمة |
الصف المفقود يمثل سؤالاً، وليس إجابة
اختفاء صف بين استجابتين هو أمر شائع ومفاجئ. قبل أن تقرر ما يعنيه، افصل بين القصص المحتملة التي يمكن أن يرويها.
ثلاث قصص وراء صف مفقود واحد
قد يكون الرابط لم يُفهرس أبداً، أو ربما تمت إزالته. القصة الثالثة تتعلق بالتوقيت: تم زحف الصفحة قبل أو بعد إعادة بناء الفهرس، ويظهر الصف في دورة لاحقة.
مكالمة واحدة لا يمكنها التمييز بين هذه الاحتمالات. فقط نسخة ثانية تؤخذ لاحقاً، بالإضافة إلى مراجعة الصفحة نفسها، تضيق الخيارات.
قيّم الصف قبل مطاردته
تحقق من درجة المجال (DR) وصفحة الربط قبل أي تواصل. نادرًا ما يغير الرابط المفقود من موقع ضعيف خطة العمل. أما الرابط المفقود من صفحة جذبت القراء فقد يستحق ملاحظة إلى صاحبها. يُظهر جدول المشتبه بهم أين يقع الصف المفقود ضمن الأسباب الأوسع.
نقل التصدير إلى مكالماتنا
هل يمكنني تصدير نفس الأعمدة التي توفرها Ahrefs؟
ليس واحداً تلو الآخر. تختلف حقول الصف حسب الإجراء، لذا افتح استجابة محفوظة ورتّب الأسماء بنفسك. يحدد الجدول أعلاه الإجراء الأقرب لكل جزء من التقرير، لكن أسماء الحقول ستختلف.
هل الـ API أرخص من اشتراك Ahrefs؟
تعتمد الإجابة على حجم المكالمات. سعرنا المنشور هو $0.10 لكل 1,000 مكالمة ذات رصيد واحد. تبيع Ahrefs وحدات API ضمن الاشتراكات، بدءاً من $129 شهرياً مقابل 200,000 وحدة، مع حد أدنى 50 وحدة لكل طلب. احسب مكالماتك قبل اتخاذ القرار.
هل ستستطيع التصاميم القديمة المقارنة مع الجديدة؟
فقط إذا تطابق الترتيب، العمق والمصدر. الملف المسحوب من أداة مختلفة في أسبوع مختلف هو عينة مختلفة. احتفظ بالملفات القديمة وابدأ السلسلة الجديدة بزوج مُعلّن بوضوح.
هل أحتاج إلى الاحتفاظ بالمفتاح على خادومي؟
نعم. CORS مفتوح، لذا يمكن للمتصفح استدعاء الـ API، لكن المفتاح الموجود في كود الواجهة الأمامية مرئي لكل زائر. أرسل الطلبات من خادومك واقرأ المفتاح من متغير البيئة.
قبل أن تبني تقريراً فوق هذه المكالمات
- افتح استجابة محفوظة واحدة لكل إجراء ولاحظ أسماء حقول الصف التي تتلقاها فعلياً.
- قرر أي تسمية شهر تدرج في كل اسم ملف.
- حافظ على
page،per،sortوorderمتطابقة بين السحوبات الشهرية. - سجّل كائن
_creditsمن كل استجابة موثقة ليكون إنفاق كل مهمة مرئياً. - حدد الحد الأقصى للتصفح العميق في سكريبتك، حيث تتوقف القوائم عند 50,000 صف.
- أضف ملاحظة حول حداثة البيانات إلى أي تقرير تقدمه، مشيراً إلى أن تحديث الفهرس يحدث شهرياً تقريباً.
قراءة الظرف
تحمل كل استجابة ok. الاستجابات الموثقة تضيف أيضاً _credits، مما يتيح لك تسجيل الإنفاق لكل مهمة ومراقبة الرصيد.
curl -s "https://rankele.com/api.php?action=toppages&q=example.com&per=50&key=sk_live_..." | head -c 600
# header style
curl -s -H "Authorization: Bearer sk_live_..." \
"https://rankele.com/api.php?action=bulk_dr&domains=example.com,example.org"تبيع Ahrefs وحدات API ضمن الاشتراكات، بدءاً من $129 شهرياً مقابل 200,000 وحدة بحد أدنى 50 وحدة لكل طلب. كما تقدم كلمات رئيسية، وتتبع الترتيب وزحف أكثر حداثة، وكذلك Semrush. نحن نغطي بيانات الروابط بسعر منخفض لكل مكالمة ولا نقدم أكثر من ذلك. استخدم دليل التشغيل الشهري إذا كان هذا هو الفجوة التي تحتاج إلى ملئها. يُعد شجرة قرارات ارتفاع النصوص المزعجة استخداماً جيداً للمكالمات السريعة منخفضة التكلفة.
