DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
تحليل المحتوى – واجهة البحث
يسرد الصفحات الفردية التي تستشهد بكلمة مفتاحية، بدلًا من الإجماليات. يحمل كل عنصر url وdomain وmain_domain وurl_rank وdomain_rank وspam_score وfetch_time وcountry وlanguage وscore وpage_category، إلى جانب total_count وitems_count. يقبل filters الحقول المدرجة في get_dataforseo_content_available_filters. للحصول على الأعداد والتوزيعات بدلًا من الصفحات، استخدم post_dataforseo_content_summary_live.
مرجع التسعير
- القياس: تكلفة الاستجابة المُبلَّغ عنها.
- تقدير الطلب المرجعي: 0.0276 دولار أمريكي.
- مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.
بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.
- النوع: array (object | null)[]
- filtersالنوع: array (object | null)[] | null
مصفوفة معاملات تصفية النتائج
حقل اختياري
يمكنك إضافة عدة عوامل تصفية دفعةً واحدة (8 كحد أقصى)
يجب تعيين معامل منطقيandأوorبين الشروط
المعاملات المدعومة:regex،not_regex،<،<=،>،>=،=،<>،in،not_in،like،not_like،match،not_match
يمكنك استخدام المعامل%معlikeوnot_likeلمطابقة أي سلسلة من صفر أو أكثر من الأحرف
مثال:["country","=", "US"][["domain_rank",">",800],"and",["content_info.connotation_types.negative",">",0.9]][["domain_rank",">",800],
"and",
[["page_types","has","ecommerce"],
"or",["content_info.text_category","has",10994]]]
لمزيد من المعلومات حول عوامل التصفية، راجع واجهة تحليل المحتوى - عوامل التصفيةكائن فارغ - keywordالنوع: string
الكلمة المفتاحية المستهدفة
حقل مطلوب
ترميز UTF-8
ستُحوَّل الكلمات المفتاحية إلى صيغة أحرف صغيرة؛
ملاحظة: لمطابقة عبارة دقيقة بدلًا من كلمة مفتاحية مستقلة، استخدم علامات الاقتباس المزدوجة والشرطات المائلة العكسية؛
مثال:"keyword": "\"tesla palo alto\""تعرّف على قواعد وقيود حقلَي
keywordوkeywordsفي واجهات DataForSEO API في مقال مركز المساعدة - keywordالنوع: object | null
_fields حقول الكلمات المفتاحية المستهدفة والكلمات المفتاحية المستهدفة
حقل اختياري
استخدم هذا المعامل لتصفية مجموعة البيانات حسب الكلمات المفتاحية التي يجب أن تحتوي عليها حقول معينة؛
الحقول التي يمكنك تحديدها:title،main_title،previous_title،snippet
يمكنك الإشارة إلى عدة حقول؛
ملاحظة: لمطابقة عبارة دقيقة بدلًا من كلمة مفتاحية مستقلة، استخدم علامات الاقتباس المزدوجة والشرطات المائلة العكسية؛
مثال:"keyword_fields": {<br>"snippet": "\"logitech mouse\"",<br>"main_title": "sale"<br>}"- propertyالنوع: string | null
Name
- limitالنوع: integer | null
الحد الأقصى لعدد الاستشهادات المعادة
حقل اختياري
القيمة الافتراضية:100
الحد الأقصى:1000 - offsetالنوع: integer | null
الإزاحة في مصفوفة نتائج الاستشهادات المعادة
حقل اختياري
القيمة الافتراضية:0
إذا حددت القيمة10، فسيُحذف أول عشرة استشهادات في مصفوفة النتائج وستُقدَّم البيانات للاستشهادات التالية
ملاحظة: نوصي باستخدام هذا المعامل فقط عند استرداد ما يصل إلى 10,000 نتيجة
لاسترداد أكثر من 10,000 نتيجة، استخدمoffset_tokenبدلًا من ذلك. - offsetالنوع: string | null
_token رمز الإزاحة للطلبات اللاحقة
حقل اختياري
يُقدَّم في الحقل نفسه في استجابة كل طلب؛
استخدم هذا المعامل لتجنّب انتهاء المهلة عند محاولة الحصول على أكثر من 10,000 نتيجة في طلب واحد؛
بتحديد قيمةoffset_tokenالفريدة من مصفوفة الاستجابة، ستحصل على النتائج اللاحقة للمهمة الأولية؛
قيمoffset_tokenفريدة لكل مهمة لاحقة
ملاحظة: إذا حُدِّدoffset_tokenفي الطلب، فلن تُؤخذ جميع المعاملات الأخرى باستثناءlimitفي الاعتبار عند معالجة المهمة
تعرّف على المزيد حول هذا المعامل في مركز المساعدة - orderالنوع: array string[] | null
_by قواعد فرز النتائج
حقل اختياري
يمكنك استخدام القيم نفسها الموجودة في مصفوفةfiltersلفرز النتائج
أنواع الفرز الممكنة:asc- تُفرز النتائج بترتيب تصاعديdesc- تُفرز النتائج بترتيب تنازلي
استخدم فاصلة لتحديد نوع الفرز
مثال:["content_info.sentiment_connotations.anger,desc"]
القاعدة الافتراضية:["content_info.sentiment_connotations.anger,desc"]
لاحظ أنه لا يمكن تعيين أكثر من ثلاث قواعد فرز في طلب واحد
استخدم فاصلة للفصل بين عدة قواعد فرز
مثال:["content_info.sentiment_connotations.anger,desc","keyword_data.keyword_info.cpc,desc"] - pageالنوع: array string[] | null
_type أنواع الصفحات المستهدفة
حقل اختياري
استخدم هذا المعامل لتصفية مجموعة البيانات حسب أنواع الصفحات
القيم الممكنة:"ecommerce"،"news"،"blogs"،"message-boards"،"organization" - rankالنوع: string | null
_scale تحدد المقياس المستخدم لحساب وعرض قيم
domain_rankوurl_rank
حقل اختيارييمكنك استخدام هذا المعامل لاختيار ما إذا كانت قيم الرتب تُعرض على مقياس 0–100 أو 0–1000
القيم الممكنة:
one_hundred— تُعرض قيم الرتب على مقياس 0–100one_thousand— تُعرض قيم الرتب على مقياس 0–1000القيمة الافتراضية:
one_thousand - searchالنوع: string | null
_mode نوع تجميع النتائج
حقل اختياري
أنواع التجميع الممكنة:as_is- يعيد جميع الاستشهادات الخاصة بـkeywordالمستهدفةone_per_domain- يعيد استشهادًا واحدًا لـkeywordلكل نطاق
القيمة الافتراضية:as_is - tagالنوع: string | null
معرّف مهمة يحدده المستخدم
حقل اختياري
الحد الأقصى للأحرف هو 255
يمكنك استخدام هذا المعامل لتمييز المهمة ومطابقتها مع النتيجة
ستجد قيمةtagالمحددة في كائنdataضمن الاستجابة
- النوع: object | null · Response36Afe1097B20_ContentAnalysisSearchLiveResponseInfo200
- النوع: number | null التنسيق: doublecost
إجمالي تكلفة المهام، بالدولار الأمريكي
- النوع: integer | nullstatus
_code رمز الحالة العام يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا
- النوع: string | nullstatus
_message رسالة معلوماتية عامة يمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا
- النوع: array (object | null)[] | nulltasks
مصفوفة المهام
- النوع: object | null · Response36Afe1097B20_ContentAnalysisSearchLiveTaskInfo
- 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
مصفوفة نتائج
- itemsالنوع: array (object | null)[] | null
تحتوي على الاستشهادات والبيانات ذات الصلة
- contentالنوع: object | null · Response36Afe1097B20_AnalysisContentInfo
_info تحتوي على بيانات عن الاستشهادات من
urlالمحدد- authorالنوع: string | null
مؤلف المحتوى
- connotationالنوع: object | null
_types أنواع الدلالات
تحتوي على أنواع المشاعر (قطبية المشاعر) المرتبطة بالاستشهاد المحدد ومؤشر الاحتمال لكل نوع من المشاعر
أنواع دلالات المشاعر الممكنة:positive،negative،neutral- propertyالنوع: integer | null التنسيق: int64
Name Signed 64-bit integers (long type).
- contentالنوع: integer | null
_quality _score درجة جودة المحتوى
تُحتسب هذه القيمة بناءً على عدد الكلمات والجمل والأحرف التي يحتويها المحتوى - contentالنوع: string | null
_type نوع المحتوى
مثال:page_content،comment - dateالنوع: string | null
_published التاريخ والوقت اللذان نُشر فيهما المحتوى
بتنسيق UTC: "yyyy-mm-dd hh-mm-ss +00:00"
مثال:2017-01-24 13:20:59 +00:00 - groupالنوع: string | null
_date التاريخ والوقت لمجموعة الاستشهادات
يشير إلى تاريخ نشر المحتوى أو التاريخ والوقت اللذين زار فيهما برنامج الزحف الخاص بنا الصفحة لأول مرة؛
يمكن استخدام هذا الحقل لتجميع الاستشهادات حسب التاريخ وعرض اتجاهات الاستشهادات؛
يُقدَّم التاريخ والوقت بتنسيق UTC: "yyyy-mm-dd hh-mm-ss +00:00"
مثال:2017-01-24 13:20:59 +00:00 - highlightedالنوع: string | null
_text النص المميّز من
snippet - languageالنوع: string | null
- levelالنوع: integer | null
مستوى عنوان
title
يشير إلى مستوى وسم h من1(الأعلى) إلى6(الأدنى) - mainالنوع: string | null
_title عنوان الصفحة
- previousالنوع: string | null
_title عنوان كتلة المحتوى السابقة
- ratingالنوع: object | null · Response36Afe1097B20_ContententRatingInfo
تقييم المحتوى
التقييم المرتبط بـcontent_info- maxالنوع: number | null التنسيق: double
_rating _value القيمة القصوى لاسم التقييم
- nameالنوع: string | null
اسم التقييم ستجد هنا العناصر التالية: Max5 وPercents وCustomMax
- ratingالنوع: integer | null التنسيق: int64
_count عدد الأصوات
- ratingالنوع: number | null التنسيق: double
_value قيمة التقييم
- relativeالنوع: number | null التنسيق: double
_rating التقييم النسبي
- semanticالنوع: string | null
_location الموقع الدلالي
يشير إلى العنصر الدلالي في HTML حيث يوجد استشهاد الكلمة المفتاحية المستهدفة
مثال:article،header - sentimentالنوع: object | null
_connotations دلالات المشاعر
تحتوي على المشاعر (ردود الفعل العاطفية) المرتبطة بالاستشهاد المحدد ومؤشر الاحتمال لكل شعور
دلالات المشاعر الممكنة:anger،happiness،love،sadness،share،fun- propertyالنوع: integer | null التنسيق: int64
Name Signed 64-bit integers (long type).
- snippetالنوع: string | null
مقتطف المحتوى
- snippetالنوع: integer | null
_length عدد أحرف المقتطف
- socialالنوع: array (object | null)[] | null
_metrics مقاييس التفاعل على وسائل التواصل الاجتماعي
بيانات عن التفاعلات على وسائل التواصل الاجتماعي المرتبطة بالمحتوى استنادًا إلى تضمينات المواقع التي تطوّرها وتدعمها منصات التواصل الاجتماعي- likeالنوع: integer | null التنسيق: int64
_count عدد الإعجابات
- typeالنوع: string | null
نوع العنصر
- textالنوع: array integer[] | null
_category - titleالنوع: string | null
عنوان النتيجة
- countryالنوع: string | null
- domainالنوع: string | null
اسم النطاق
- domainالنوع: integer | null
_rank - fetchالنوع: string | null
_time تاريخ ووقت زيارة الزاحف لدينا للصفحة
بتنسيق UTC: "yyyy-mm-dd hh-mm-ss +00:00"
مثال:2017-01-24 13:20:59 +00:00 - languageالنوع: string | null
- mainالنوع: string | null
_domain النطاق الرئيسي
- pageالنوع: array integer[] | null
_category - pageالنوع: array string[] | null
_types أنواع الصفحات
- ratingsالنوع: array (object | null)[] | null
التقييمات الموجودة في الصفحة
جميع التقييمات الموجودة في الصفحة استنادًا إلى البيانات الوصفية الدقيقة (microdata)- maxالنوع: number | null التنسيق: double
_rating _value القيمة القصوى لاسم التقييم
- nameالنوع: string | null
اسم التقييم ستجد هنا العناصر التالية: Max5 وPercents وCustomMax
- ratingالنوع: integer | null التنسيق: int64
_count عدد الأصوات
- ratingالنوع: number | null التنسيق: double
_value قيمة التقييم
- relativeالنوع: number | null التنسيق: double
_rating التقييم النسبي
- scoreالنوع: number | null
درجة بروز الاستشهاد
تستند هذه القيمة إلىurl_rankوdomain_rankوkeywordووجودها فيtitleوmain_titleوurlوsnippet
كلما زادتscore، زادت قيمة الاستشهاد المرتبط - socialالنوع: array (object | null)[] | null
_metrics مقاييس التفاعل على وسائل التواصل الاجتماعي
بيانات عن التفاعلات على وسائل التواصل الاجتماعي المرتبطة بالمحتوى استنادًا إلى تضمينات المواقع التي تطوّرها وتدعمها منصات التواصل الاجتماعي- likeالنوع: integer | null التنسيق: int64
_count عدد الإعجابات
- typeالنوع: string | null
نوع العنصر
- spamالنوع: integer | null
_score - typeالنوع: string | null
نوع العنصر
- urlالنوع: string | null
عنوان URL الذي عُثر فيه على الاستشهاد
- urlالنوع: integer | null
_rank
- itemsالنوع: integer | null التنسيق: int64
_count عدد النتائج المُعادة في مصفوفة
items - offsetالنوع: string | null
_token رمز الإزاحة للطلبات اللاحقة
يمكنك استخدام السلسلة المقدّمة في هذا الحقل للحصول على النتائج اللاحقة للمهمة الأولية؛
ملاحظة: قيمoffset_tokenفريدة لكل مهمة لاحقة - 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/content_analysis/search/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keyword_fields": {
"snippet": "logitech"
},
"keyword": "logitech",
"page_type": [
"ecommerce",
"news",
"blogs",
"message-boards",
"organization"
],
"search_mode": "as_is",
"filters": [
"main_domain",
"=",
"reviewfinder.ca"
],
"order_by": [
"content_info.sentiment_connotations.anger,desc"
],
"limit": 10
}
]'
{
"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": [
{
"offset_token": null,
"total_count": null,
"items_count": null,
"items": [
{
"type": null,
"url": null,
"domain": null,
"main_domain": null,
"url_rank": null,
"spam_score": null,
"domain_rank": null,
"fetch_time": null,
"country": null,
"language": null,
"score": null,
"page_category": [
"[Max Depth Exceeded]"
],
"page_types": [
"[Max Depth Exceeded]"
],
"ratings": [
"[Max Depth Exceeded]"
],
"social_metrics": [
"[Max Depth Exceeded]"
],
"content_info": "[Max Depth Exceeded]"
}
]
}
]
}
]
}