DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
الروابط الخلفية
الروابط الواردة الفردية إلى target واحد، صف واحد لكل رابط. يعيد total_count وitems_count وitems وsearch_after_token للترقيم — استخدمه بدلًا من offset بعد الصفحات القليلة الأولى. يتحكّم mode وcustom_mode في التجميع، ويحدّد backlinks_status_type المباشر أو المفقود أو الكل. للأعداد بدلًا من الصفوف استخدم post_dataforseo_backlinks_summary_live؛ وللنطاقات الرابطة مجمّعة، post_dataforseo_backlinks_referring_domains_live.
مرجع التسعير
- القياس: تكلفة الاستجابة المُبلَّغ عنها.
- تقدير الطلب المرجعي: 0.06 دولار أمريكي.
- مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.
بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.
- النوع: array (object | null)[]
- backlinksالنوع: string | null
_status _type تحديد الروابط الخلفية التي ستُعاد وتُحتسب
حقل اختياري
يمكنك استخدام هذا الحقل لاختيار الروابط الخلفية التي ستُعاد وتُستخدم للمقاييس المجمعة لـtarget؛
القيم الممكنة:all— تُعاد جميع الروابط الخلفية وتُحتسب؛live— تُعاد الروابط الخلفية التي عُثر عليها خلال الفحص الأخير وتُحتسب؛lost— تُعاد الروابط الخلفية المفقودة وتُحتسب؛القيمة الافتراضية:
live - customالنوع: object | null
_mode نوع تجميع النتائج التفصيلية
حقل اختياري
استخدم هذا الكائن للحصول على عدد محدد من الروابط الخلفية لكلfield
إذا استخدمتcustom_mode، فسيُتجاهلmode
مثال:"custom_mode": {"field": "domain", "value": 100}- propertyالنوع: object | null
Name
- excludeالنوع: boolean | null
_internal _backlinks يشير إلى ما إذا كانت الروابط الخلفية الداخلية من النطاقات الفرعية إلى
targetستُستبعد من النتائج
حقل اختياري
إذا ضُبط علىtrue، فلن تتضمن النتائج بيانات عن الروابط الخلفية الداخلية من النطاقات الفرعية للنطاق نفسه الخاص بـtarget
إذا ضُبط علىfalse، فستُضمَّن الروابط الداخلية في النتائج
القيمة الافتراضية:true - filtersالنوع: array (object | null)[] | null
مصفوفة معاملات تصفية النتائج
حقل اختياري
يمكنك إضافة عدة عوامل تصفية دفعةً واحدة (8 كحد أقصى)
يجب تعيين معامل منطقيandأوorبين الشروط
المعاملات المدعومة:=،<>،in،not_in،like،not_like،ilike،not_ilike،regex،not_regex،match،not_match
يمكنك استخدام المعامل%معlikeوnot_likeلمطابقة أي سلسلة من صفر أو أكثر من الأحرف
مثال:["rank",">","80"][["page_from_rank",">","55"],
"and",
["dofollow","=",true]][["first_seen",">","2017-10-23 11:31:45 +00:00"],
"and",
[["anchor","like","%seo%"],"or",["text_pre","like","%seo%"]]]كائن فارغ - includeالنوع: boolean | null
_subdomains يشير إلى ما إذا كانت النطاقات الفرعية لـ
targetستُضمَّن في البحث
حقل اختياري
إذا ضُبط علىfalse، فستُتجاهل النطاقات الفرعية
القيمة الافتراضية:true - limitالنوع: integer | null
الحد الأقصى لعدد الروابط الخلفية المعادة
حقل اختياريالقيمة الافتراضية:
100
الحد الأقصى:1000 - modeالنوع: string | null
نوع تجميع النتائج
حقل اختياري
أنواع التجميع الممكنة:as_is— يعيد جميع الروابط الخلفيةone_per_domain— يعيد رابطًا خلفيًا واحدًا لكل نطاقone_per_anchor— يعيد رابطًا خلفيًا واحدًا لكل نص رابطالقيمة الافتراضية:
as_is - offsetالنوع: integer | null
الإزاحة في مصفوفة نتائج الروابط الخلفية المعادة
حقل اختياريالقيمة الافتراضية:
0
إذا حددت القيمة10، فسيُحذف أول عشرة روابط خلفية في مصفوفة النتائج وستُقدَّم البيانات للروابط الخلفية التالية؛
ملاحظة: الحد الأقصى هو20,000، استخدمsearch_after_tokenإذا أردت إزاحة نتائج أكثر - orderالنوع: array string[] | null
_by قواعد فرز النتائج
حقل اختياري
يمكنك استخدام القيم نفسها الموجودة في مصفوفةfiltersلفرز النتائج
أنواع الفرز الممكنة:asc— تُفرز النتائج بترتيب تصاعديdesc— تُفرز النتائج بترتيب تنازلي
استخدم فاصلة لتحديد نوع الفرز
مثال:["rank,desc"]
لاحظ أنه لا يمكن تعيين أكثر من ثلاث قواعد فرز في طلب واحد
استخدم فاصلة للفصل بين عدة قواعد فرز
مثال:["domain_from_rank,desc","page_from_rank,asc"] - rankالنوع: string | null
_scale تحدد المقياس المستخدم لحساب وعرض قيم
rankوdomain_from_rankوpage_from_rank
حقل اختيارييمكنك استخدام هذا المعامل لاختيار ما إذا كانت قيم الرتب تُعرض على مقياس 0–100 أو 0–1000
القيم الممكنة:
one_hundred— تُعرض قيم الرتب على مقياس 0–100one_thousand— تُعرض قيم الرتب على مقياس 0–1000القيمة الافتراضية:
one_thousandتعرّف على طريقة عمل هذا المعامل وكيفية حساب مقاييس الترتيب في مقالة مركز المساعدة هذه
- searchالنوع: string | null
_after _token رمز للطلبات اللاحقة
حقل اختياري
يُقدَّم في الحقل المماثل في استجابة كل طلب؛
استخدم هذا المعامل لتجنب مهل الانتظار عند محاولة الحصول على أكثر من20,000نتيجة في طلب واحد؛
وبتحديد قيمةsearch_after_tokenالفريدة من مصفوفة الاستجابة، ستحصل على النتائج اللاحقة للمهمة الأولية؛
قيمsearch_after_tokenفريدة لكل مهمة لاحقة؛
ملاحظة: إذا حُددsearch_after_tokenفي الطلب، فيجب أن تكون جميع المعاملات الأخرى مطابقة للطلب السابق - tagالنوع: string | null
معرّف مهمة يحدده المستخدم
حقل اختياري
الحد الأقصى للأحرف هو 255
يمكنك استخدام هذا المعامل لتمييز المهمة ومطابقتها مع النتيجة
ستجد قيمةtagالمحددة في كائنdataضمن الاستجابة - targetالنوع: string
النطاق أو النطاق الفرعي أو صفحة الويب المطلوب الحصول على الروابط الخلفية لها
حقل مطلوب
يجب تحديد النطاق أو النطاق الفرعي دونhttps://وwww.
يجب تحديد الصفحة بعنوان URL مطلق (بما في ذلكhttp://أوhttps://)
- النوع: object | null · Response36Afe1097B20_BacklinksBacklinksLiveResponseInfo200
- النوع: number | null التنسيق: doublecost
إجمالي تكلفة المهام، بالدولار الأمريكي
- النوع: integer | nullstatus
_code رمز الحالة العام يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا
- النوع: string | nullstatus
_message رسالة معلوماتية عامة يمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا
- النوع: array (object | null)[] | nulltasks
مصفوفة المهام
- النوع: object | null · Response36Afe1097B20_BacklinksBacklinksLiveTaskInfo
- 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
مصفوفة نتائج
- customالنوع: object | null
_mode الوضع المخصص المحدد في مصفوفة POST
- propertyالنوع: object | null
Name
- itemsالنوع: array (object | null)[] | null
يحتوي على بيانات الروابط الخلفية والنطاقات المُحيلة ذات الصلة
- altالنوع: string | null
النص البديل للصورة
سيكون هذا الحقلnullإذا لم يكنtypeالرابط الخلفي صورة - anchorالنوع: string | null
نص ارتباط الرابط الخلفي
- attributesالنوع: array (string | null)[] | null
سمات الروابط المُحيلة
مثال:nofollow - backlinkالنوع: integer | null
_spam _score - dofollowالنوع: boolean | null
يشير إلى ما إذا كان الرابط الخلفي dofollow
إذا كانت القيمةfalse، فالرابط الخلفي nofollow - domainالنوع: string | null
_from النطاق الذي يشير إلى النطاق الهدف أو صفحة الويب
- domainالنوع: string | null
_from _country رمز الدولة ISO للنطاق المُحيل
- domainالنوع: string | null
_from _ip عنوان IP للنطاق المُحيل
- domainالنوع: boolean | null
_from _is _ip يشير إلى ما إذا كان النطاق عنوان IP
إذا كانت القيمةtrue، يعمل النطاق كعنوان IP وليس له اسم نطاق - domainالنوع: array (string | null)[] | null
_from _platform _type أنواع المنصات للنطاق المُحيل
القيم الممكنة:
cms،blogs،ecommerce،message-boards،wikis،news،organization - domainالنوع: integer | null
_from _rank - domainالنوع: string | null
_to النطاق الذي يشير إليه الرابط الخلفي
- firstالنوع: string | null
_seen التاريخ والوقت اللذان وجد فيهما الزاحف الرابط الخلفي أول مرة
بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00 - groupالنوع: integer | null التنسيق: int64
_count يشير إلى إجمالي عدد الروابط الخلفية من هذا النطاق
على سبيل المثال، إذا كانmodeمضبوطًا علىone_per_domain، فسيشير هذا الحقل إلى إجمالي عدد الروابط الخلفية الواردة من هذا النطاق - imageالنوع: string | null
_url عنوان URL للصورة
عنوان URL المؤدي إلى الصورة على المصدر الأصلي أو مخزن DataForSEO (إذا لم يكن المصدر الأصلي متاحًا) - indirectالنوع: array (object | null)[] | null
_link _path مسار الرابط غير المباشر
يشير إلى عنوان URL أو سلسلة عناوين URL تؤدي إلىurl_to- statusالنوع: integer | null
_code رمز الحالة العام
يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا
ملاحظة: نوصي بشدة بتصميم نظام ضروري لمعالجة الحالات الاستثنائية أو الأخطاء ذات الصلة - typeالنوع: string | null
نوع العنصر
- urlالنوع: string | null
عنوان URL للرابط غير المباشر
- isالنوع: boolean | null
_broken يشير إلى ما إذا كان الرابط الخلفي معطوبًا
إذا كانت القيمةtrue، فالرابط الخلفي يشير إلى صفحة تستجيب برمز حالة 4xx أو 5xx - isالنوع: boolean | null
_indirect _link يشير إلى ما إذا كان الرابط الخلفي رابطًا غير مباشر
إذا كانت القيمةtrue، فالرابط الخلفي رابط غير مباشر يشير إلى صفحة تعيد التوجيه إلىurl_toأو تشير إلى صفحة أساسية (canonical) - isالنوع: boolean | null
_lost يشير إلى ما إذا كان الرابط الخلفي قد أُزيل
إذا كانت القيمةtrue، فقد أُزيل الرابط الخلفي أو الصفحة بأكملها - isالنوع: boolean | null
_new يشير إلى ما إذا كان الرابط الخلفي جديدًا
إذا كانت القيمةtrue، فقد وُجد الرابط الخلفي على الصفحة آخر مرة زارها الزاحف - itemالنوع: string | null
_type نوع الرابط
القيم الممكنة:anchor،image،meta،canonical،alternate،redirect - lastالنوع: string | null
_seen أحدث تاريخ زار فيه الزاحف الرابط الخلفي
بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00 - linksالنوع: integer | null التنسيق: int64
_count عدد الروابط الخلفية المتطابقة الموجودة في الصفحة المُحيلة
- originalالنوع: boolean | null
يشير إلى ما إذا كان الرابط الخلفي موجودًا في الصفحة المُحيلة عندما زارها الزاحف أول مرة
- pageالنوع: string | null
_from _encoding ترميز الأحرف للصفحة المُحيلة
مثال:utf-8 - pageالنوع: integer | null
_from _external _links عدد الروابط الخارجية الموجودة في الصفحة المُحيلة
- pageالنوع: integer | null
_from _internal _links عدد الروابط الداخلية الموجودة في الصفحة المُحيلة
- pageالنوع: string | null
_from _language لغة الصفحة المُحيلة
بتنسيق ISO 639-1
مثال:en - pageالنوع: integer | null
_from _rank - pageالنوع: integer | null
_from _size حجم الصفحة المُحيلة بالبايت
مثال:63357 - pageالنوع: integer | null
_from _status _code رمز حالة HTTP الذي تعيده الصفحة المُحيلة
مثال:200 - pageالنوع: string | null
_from _title عنوان الصفحة المُحيلة
- prevالنوع: string | null
_seen الموعد السابق لأحدث تاريخ زار فيه الزاحف الرابط الخلفي
بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00 - rankالنوع: integer | null
- rankedالنوع: object | null · Response36Afe1097B20_RankedKeywordsInfo
_keywords _info - pageالنوع: integer | null التنسيق: int64
_from _keywords _count _top _10 Signed 64-bit integers (long type).
- pageالنوع: integer | null التنسيق: int64
_from _keywords _count _top _100 Signed 64-bit integers (long type).
- pageالنوع: integer | null التنسيق: int64
_from _keywords _count _top _3 Signed 64-bit integers (long type).
- semanticالنوع: string | null
_location - textالنوع: string | null
_post المقتطف الذي يلي نص الارتباط
- textالنوع: string | null
_pre المقتطف الذي يسبق نص الارتباط
- tldالنوع: string | null
_from النطاق الأعلى مستوى لعنوان URL المُحيل
- typeالنوع: string | null
نوع العنصر
- urlالنوع: string | null
_from عنوان URL للصفحة التي وُجد فيها الرابط الخلفي
- urlالنوع: boolean | null
_from _https يشير إلى ما إذا كان عنوان URL المُحيل مؤمّنًا عبر HTTPS
إذا كانت القيمةtrue، فعنوان URL المُحيل مؤمّن عبر HTTPS - urlالنوع: string | null
_to عنوان URL الذي يشير إليه الرابط الخلفي
- urlالنوع: boolean | null
_to _https يشير إلى ما إذا كان عنوان URL الذي يشير إليه الرابط الخلفي مؤمّنًا عبر HTTPS
إذا كانت القيمةtrue، فعنوان URL مؤمّن عبر HTTPS - urlالنوع: string | null
_to _redirect _target عنوان URL الهدف لإعادة التوجيه
الصفحة الهدف التي تشير إليها إعادة التوجيه - urlالنوع: integer | null
_to _spam _score - urlالنوع: integer | null
_to _status _code رمز الحالة للصفحة المُشار إليها
إذا كانت القيمةnull، فالزاحف لم يزر بعد صفحة الويب التي يشير إليها الرابط
مثال:200
- itemsالنوع: integer | null التنسيق: int64
_count عدد النتائج المُعادة في مصفوفة
items - modeالنوع: string | null
الوضع المحدد في مصفوفة POST
- searchالنوع: string | null
_after _token رمز للطلبات اللاحقة
بتحديدsearch_after_tokenالفريد عند إعداد مهمة جديدة، ستحصل على النتائج اللاحقة للمهمة الأولية؛
قيمsearch_after_tokenفريدة لكل مهمة لاحقة - targetالنوع: string | null
النطاق الهدف في مصفوفة POST
- totalالنوع: integer | null التنسيق: int64
_count العدد الإجمالي للنتائج ذات الصلة بالطلب
- 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/backlinks/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "forbes.com",
"mode": "as_is",
"filters": [
"dofollow",
"=",
true
],
"limit": 5
}
]'
{
"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,
"mode": null,
"custom_mode": null,
"total_count": null,
"items_count": null,
"items": [
{
"type": null,
"domain_from": null,
"url_from": null,
"url_from_https": null,
"domain_to": null,
"url_to": null,
"url_to_https": null,
"tld_from": null,
"is_new": null,
"is_lost": null,
"backlink_spam_score": null,
"rank": null,
"page_from_rank": null,
"domain_from_rank": null,
"domain_from_platform_type": [
"[Max Depth Exceeded]"
],
"domain_from_is_ip": null,
"domain_from_ip": null,
"domain_from_country": null,
"page_from_external_links": null,
"page_from_internal_links": null,
"page_from_size": null,
"page_from_encoding": null,
"page_from_language": null,
"page_from_title": null,
"page_from_status_code": null,
"first_seen": null,
"prev_seen": null,
"last_seen": null,
"item_type": null,
"attributes": [
"[Max Depth Exceeded]"
],
"dofollow": null,
"original": null,
"alt": null,
"image_url": null,
"anchor": null,
"text_pre": null,
"text_post": null,
"semantic_location": null,
"links_count": null,
"group_count": null,
"is_broken": null,
"url_to_status_code": null,
"url_to_spam_score": null,
"url_to_redirect_target": null,
"ranked_keywords_info": "[Max Depth Exceeded]",
"is_indirect_link": null,
"indirect_link_path": [
"[Max Depth Exceeded]"
]
}
],
"search_after_token": null
}
]
}
]
}