DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
ملخص الروابط الخلفية
ملف الروابط الخلفية الكامل لـtarget واحد في استدعاء واحد: first_seen وlost_date وrank وbacklinks وbacklinks_spam_score وcrawled_pages وinternal_links_count وكتلة info، مع أعداد النطاقات المُحيلة ونصوص الروابط إلى جانبها. هذه محور العائلة — ابدأ هنا، ثم تعمّق في الجزء المهم: post_dataforseo_backlinks_backlinks_live للروابط الفردية، وpost_dataforseo_backlinks_referring_domains_live لمن يربط، وpost_dataforseo_backlinks_anchors_live للنص المستخدم. لا تأخذ هذه النقطة معامل حد أقصى، لذا فالخيار الوحيد هو استدعاؤها بوتيرة أقل.
مرجع التسعير
- القياس: تكلفة الاستجابة المُبلَّغ عنها.
- تقدير الطلب المرجعي: 0.024 دولار أمريكي.
- مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.
بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.
- النوع: array (object | null)[]
- backlinksالنوع: array (object | null)[] | null
_filters تصفية الروابط الخلفية الخاصة بـ
target
حقل اختياري
يمكنك استخدام هذا الحقل لتصفية الروابط الخلفية الأولية التي ستُضمَّن في مجموعة البيانات الخاصة بالمقاييس المجمعة لـtarget
يمكنك تصفية الروابط الخلفية حسب جميع الحقول المتاحة في استجابة نقطة النهاية هذه
باستخدام هذا المعامل، يمكنك تضمين الروابط الخلفية dofollow فقط في الاستجابة وإنشاء مجموعة بيانات روابط خلفية مرنة لحساب المقاييس لها
مثال:"backlinks_filters": ["dofollow", "=", true]كائن فارغ - backlinksالنوع: string | null
_status _type تحديد الروابط الخلفية التي ستُعاد وتُحتسب
حقل اختياري
يمكنك استخدام هذا الحقل لاختيار الروابط الخلفية التي ستُعاد وتُستخدم للمقاييس المجمعة لـtarget؛
القيم الممكنة:all— تُعاد جميع الروابط الخلفية وتُحتسب؛live— تُعاد الروابط الخلفية التي عُثر عليها خلال الفحص الأخير وتُحتسب؛lost— تُعاد الروابط الخلفية المفقودة وتُحتسب؛القيمة الافتراضية:
live - excludeالنوع: boolean | null
_internal _backlinks يشير إلى ما إذا كانت الروابط الخلفية الداخلية من النطاقات الفرعية إلى
targetستُستبعد من النتائج
حقل اختياري
إذا ضُبط علىtrue، فلن تتضمن النتائج بيانات عن الروابط الخلفية الداخلية من النطاقات الفرعية للنطاق نفسه الخاص بـtarget
إذا ضُبط علىfalse، فستُضمَّن الروابط الداخلية في النتائج
القيمة الافتراضية:true - includeالنوع: boolean | null
_indirect _links يشير إلى ما إذا كانت الروابط غير المباشرة إلى
targetستُضمَّن في النتائج
حقل اختياري
إذا ضُبط علىtrue، فستتضمن النتائج بيانات عن الروابط غير المباشرة التي تشير إلى صفحة تعيد التوجيه إلى الهدف أو تشير إلى صفحة أساسية
إذا ضُبط علىfalse، فستُتجاهل الروابط غير المباشرة
القيمة الافتراضية:true - includeالنوع: boolean | null
_subdomains يشير إلى ما إذا كانت النطاقات الفرعية لـ
targetستُضمَّن في البحث
حقل اختياري
إذا ضُبط علىfalse، فستُتجاهل النطاقات الفرعية
القيمة الافتراضية:true - internalالنوع: integer | null
_list _limit الحد الأقصى لعدد العناصر داخل المصفوفات الداخلية
حقل اختياري
يمكنك استخدام هذا الحقل لتقييد عدد العناصر في المصفوفات التالية:referring_links_tldreferring_links_typesreferring_links_attributesreferring_links_platform_typesreferring_links_semantic_locationsالقيمة الافتراضية:
10
الحد الأقصى:1000 - rankالنوع: string | null
_scale تحدد المقياس المستخدم لحساب وعرض قيم
rankوdomain_from_rankوpage_from_rank
حقل اختيارييمكنك استخدام هذا المعامل لاختيار ما إذا كانت قيم الرتب تُعرض على مقياس 0–100 أو 0–1000
القيم الممكنة:
one_hundred— تُعرض قيم الرتب على مقياس 0–100one_thousand— تُعرض قيم الرتب على مقياس 0–1000القيمة الافتراضية:
one_thousandتعرّف على طريقة عمل هذا المعامل وكيفية حساب مقاييس الترتيب في مقالة مركز المساعدة هذه
- tagالنوع: string | null
معرّف مهمة يحدده المستخدم
حقل اختياري
الحد الأقصى للأحرف هو 255
يمكنك استخدام هذا المعامل لتمييز المهمة ومطابقتها مع النتيجة
ستجد قيمةtagالمحددة في كائنdataضمن الاستجابة - targetالنوع: string
النطاق أو النطاق الفرعي أو صفحة الويب المطلوب الحصول على البيانات لها
حقل مطلوب
يجب تحديد النطاق أو النطاق الفرعي دونhttps://وwww.
يجب تحديد الصفحة بعنوان URL مطلق (بما في ذلكhttp://أوhttps://)
- النوع: object | null · Response36Afe1097B20_BacklinksSummaryLiveResponseInfo200
- النوع: number | null التنسيق: doublecost
إجمالي تكلفة المهام، بالدولار الأمريكي
- النوع: integer | nullstatus
_code رمز الحالة العام يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا
- النوع: string | nullstatus
_message رسالة معلوماتية عامة يمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا
- النوع: array (object | null)[] | nulltasks
مصفوفة المهام
- النوع: object | null · Response36Afe1097B20_BacklinksSummaryLiveTaskInfo
- costالنوع: number | null التنسيق: double
إجمالي تكلفة المهام، بالدولار الأمريكي
- dataالنوع: object | null
يحتوي على المعاملات نفسها التي حددتها في طلب POST
- propertyالنوع: object | null
Name
- idالنوع: string | null
معرّف المهمة معرّف مهمة فريد في نظامنا بصيغة UUID
- pathالنوع: array (string | null)[] | null
مسار URL
- resultالنوع: array (object | null)[] | null
مصفوفة نتائج
- backlinksالنوع: integer | null التنسيق: int64
يشير إلى عدد الروابط الخلفية
- backlinksالنوع: integer | null التنسيق: int64
_spam _score - brokenالنوع: integer | null التنسيق: int64
_backlinks عدد الروابط الخلفية المعطوبة
عدد الروابط الخلفية المعطوبة التي تشير إلىtarget - brokenالنوع: integer | null
_pages عدد الصفحات المعطوبة
عدد الصفحات علىtargetالتي تستجيب برموز حالة 4xx أو 5xxلاحظ أن عدد الصفحات المعطوبة يشمل الصفحات على
targetالمكتشفة عبر تتبّع الروابط الخارجية، لكنه قد يشمل أيضًا صفحات اكتُشفت عبر تتبّع خريطة موقع الهدف - crawledالنوع: integer | null
_pages عدد الصفحات المزحوفة لـ
target - externalالنوع: integer | null التنسيق: int64
_links _count عدد الروابط الخارجية في الصفحة
يُحسب كمجموع الروابط الخارجية في صفحاتtargetالمحدد - firstالنوع: string | null
_seen التاريخ والوقت اللذان وجد فيهما الزاحف الرابط الخلفي لـ
targetأول مرة
بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00 - infoالنوع: object | null · Response36Afe1097B20_TargetInfo
معلومات عن
target- cmsالنوع: string | null
نظام إدارة المحتوى
- countryالنوع: string | null
رمز الدولة التي يُحدَّد انتماء نطاق
targetإليها - ipالنوع: string | null
_address عنوان IP الخاص بـ
target - isالنوع: boolean | null
_ip يشير إلى ما إذا كان
targetعنوان IP
إذا كانت القيمةtrue، يعمل النطاق أو النطاق الفرعي أو صفحة الويب كعنوان IP ولا يكون له اسم نطاق - platformالنوع: array (string | null)[] | null
_type نوع المنصة
- serverالنوع: string | null
الخادم
- targetالنوع: integer | null
_spam _score
- internalالنوع: integer | null التنسيق: int64
_links _count عدد الروابط الداخلية
يُحسب كمجموع الروابط الداخلية في صفحاتtargetالمحدد - lostالنوع: string | null
_date التاريخ والوقت اللذان فُقد فيهما الرابط الخلفي
يشير إلى التاريخ والوقت اللذين زار فيهما الزاحف الهدف فاستجاب برمز حالة 4xx أو 5xx، أو أُزيل آخر رابط خلفي له
بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00 - rankالنوع: integer | null
- referringالنوع: integer | null التنسيق: int64
_domains يشير إلى عدد النطاقات المُحيلة
تشمل النطاقات المُحيلة النطاقات الفرعية التي تُحتسب نطاقات منفصلة لهذا المقياس - referringالنوع: integer | null التنسيق: int64
_domains _nofollow عدد النطاقات التي تشير برابط nofollow واحد على الأقل إلى
target - referringالنوع: integer | null التنسيق: int64
_ips عدد عناوين IP المُحيلة
عدد عناوين IP التي تشير إلى هذه الصفحة - referringالنوع: object | null
_links _attributes سمات الروابط المُحيلة
يشير إلى سمات الروابط المُحيلة وعدد الروابط لكل سمة
أمثلة على القيم:nofollow،noopener،noreferrer،external،ugc،sponsored- propertyالنوع: integer | null التنسيق: int64
Name Signed 64-bit integers (long type).
- referringالنوع: object | null
_links _countries رموز الدول ISO للروابط المُحيلة
يشير إلى رموز الدول ISO للنطاقات التي توجد فيها الروابط المُحيلة وعدد الروابط لكل دولة- propertyالنوع: integer | null التنسيق: int64
Name Signed 64-bit integers (long type).
- referringالنوع: object | null
_links _platform _types أنواع المنصات المُحيلة
يشير إلى أنواع المنصات المُحيلة وعدد الروابط لكل منصةالقيم الممكنة:
cms،blogs،ecommerce،message-boards،wikis،news،organization- propertyالنوع: integer | null التنسيق: int64
Name Signed 64-bit integers (long type).
- referringالنوع: object | null
_links _semantic _locations - propertyالنوع: integer | null التنسيق: int64
Name Signed 64-bit integers (long type).
- referringالنوع: object | null
_links _tld النطاقات الأعلى مستوى للروابط المُحيلة
يحتوي على النطاقات الأعلى مستوى وعدد الروابط المُحيلة لكل منها- propertyالنوع: integer | null التنسيق: int64
Name Signed 64-bit integers (long type).
- referringالنوع: object | null
_links _types أنواع الروابط المُحيلة
يشير إلى أنواع الروابط المُحيلة وعدد الروابط لكل نوع
القيم الممكنة:anchor،image،link،meta،canonical،alternate،redirect- propertyالنوع: integer | null التنسيق: int64
Name Signed 64-bit integers (long type).
- referringالنوع: integer | null التنسيق: int64
_main _domains يشير إلى عدد النطاقات الرئيسية المُحيلة
- referringالنوع: integer | null التنسيق: int64
_main _domains _nofollow عدد النطاقات الرئيسية التي تشير برابط nofollow واحد على الأقل إلى
target - referringالنوع: integer | null التنسيق: int64
_pages يشير إلى عدد الصفحات التي تشير إلى الهدف
- referringالنوع: integer | null التنسيق: int64
_pages _nofollow عدد الصفحات المُحيلة التي تشير برابط nofollow واحد على الأقل إلى
target - referringالنوع: integer | null التنسيق: int64
_subnets عدد الشبكات الفرعية المُحيلة
- targetالنوع: string | null
targetفي مصفوفة POST
- resultالنوع: integer | null التنسيق: int64
_count عدد العناصر في مصفوفة result
- statusالنوع: integer | null
_code رمز حالة المهمة ينشئه DataForSEO ويمكن أن يقع ضمن النطاق التالي: 10000-60000 يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا
- statusالنوع: string | null
_message الرسالة المعلوماتية للمهمة يمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا
- timeالنوع: string | null
وقت التنفيذ، بالثواني
- النوع: integer | null التنسيق: int64tasks
_count عدد المهام في مصفوفة tasks
- النوع: integer | null التنسيق: int64tasks
_error عدد المهام في مصفوفة tasks التي أُعيدت مع خطأ
- النوع: string | nulltime
إجمالي وقت التنفيذ، بالثواني
- النوع: string | nullversion
الإصدار الحالي من API
application/json - 400
تعذّرت معالجة الطلب. تحقق من معاملات الطلب.
- 401
مطلوب مفتاح API صالح من Felo.
- 402
لا يمكن متابعة الطلب لأن أحد متطلبات الفوترة غير مستوفٍ.
- 403
الحساب غير مصرّح له بهذه العملية.
- 429
تم بلوغ حد الطلبات أو حد الإنفاق.
- 502
تعذّر على الخدمة إكمال الطلب.
- 503
خدمة API أو الفوترة غير متاحة مؤقتًا.
- 504
انتهت مهلة الخدمة أثناء معالجة الطلب.
- default
استجابة خطأ؛ قد تستخدم استجابات المنبع الممرَّرة تنسيقات المزوّد
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/summary/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "explodingtopics.com",
"internal_list_limit": 10,
"include_subdomains": true,
"backlinks_filters": [
"dofollow",
"=",
true
],
"backlinks_status_type": "all"
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"target": null,
"first_seen": null,
"lost_date": null,
"rank": null,
"backlinks": null,
"backlinks_spam_score": null,
"crawled_pages": null,
"info": {
"server": null,
"cms": null,
"platform_type": [
"[Max Depth Exceeded]"
],
"ip_address": null,
"country": null,
"is_ip": null,
"target_spam_score": null
},
"internal_links_count": null,
"external_links_count": null,
"broken_backlinks": null,
"broken_pages": null,
"referring_domains": null,
"referring_domains_nofollow": null,
"referring_main_domains": null,
"referring_main_domains_nofollow": null,
"referring_ips": null,
"referring_subnets": null,
"referring_pages": null,
"referring_pages_nofollow": null,
"referring_links_tld": null,
"referring_links_types": null,
"referring_links_attributes": null,
"referring_links_platform_types": null,
"referring_links_semantic_locations": null,
"referring_links_countries": null
}
]
}
]
}