DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
الملخّص في OnPage API
حالة زحف واحد ومقاييسه الرئيسية، حسب id. يعيد crawl_progress وcrawl_status وcrawl_gateway_address وcrawl_stop_reason وdomain_info وpage_metrics. الاستجابة مغلّفة في غلاف DataForSEO: البيانات في tasks[0].result، والنتيجة في tasks[0].status_code — ولا يزال الطلب المرفوض يعيد HTTP 200. هذه أيضًا طريقة معرفة انتهاء الزحف — استقصِها حتى يصبح crawl_progress هو finished قبل قراءة أي نقطة نهاية أخرى هنا، وإلا ستقرأ نتائج جزئية تبدو حقيقية. 💰 مجاني من المنبع: الاستعلام عن زحف منتهٍ لا يكلّف شيئًا، الزحف نفسه فقط.
مرجع التسعير
- القياس: تكلفة الاستجابة المُبلَّغ عنها.
- تقدير الطلب المرجعي: 0.012 دولار أمريكي.
- مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.
بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.
- النوع: object | null · Response36Afe1097B20_OnPageSummaryResponseInfo200
- النوع: number | null التنسيق: doublecost
إجمالي تكلفة المهام، بالدولار الأمريكي
- النوع: integer | nullstatus
_code رمز الحالة العام يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا
- النوع: string | nullstatus
_message رسالة معلوماتية عامة يمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا
- النوع: array (object | null)[] | nulltasks
مصفوفة المهام
- النوع: object | null · Response36Afe1097B20_OnPageSummaryTaskInfo
- 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
مصفوفة نتائج
- crawlالنوع: string | null
_gateway _address - crawlالنوع: string | null
_progress حالة جلسة الزحف
القيم الممكنة:in_progress،finished - crawlالنوع: object | null · Response36Afe1097B20_CrawlStatusInfo
_status تفاصيل جلسة الزحف
- maxالنوع: integer | null التنسيق: int64
_crawl _pages الحد الأقصى لعدد الصفحات المراد الزحف إليها يشير إلى حد max_crawl_pages الذي حددته عند إعداد المهمة
- pagesالنوع: integer | null التنسيق: int64
_crawled عدد الصفحات المزحوفة
- pagesالنوع: integer | null التنسيق: int64
_in _queue عدد الصفحات الموجودة حاليًا في قائمة انتظار الزحف
- crawlالنوع: string | null
_stop _reason سبب إيقاف الزحف
معلومات عن سبب إيقاف عملية الزحف؛
القيم الممكنة:limit_exceeded- تجاوز الحد المحدد فيmax_crawl_pages؛empty_queue- جرى الزحف إلى جميع عناوين URL في قائمة الانتظار؛force_stopped- أُوقفت عملية الزحف باستخدام On Page API Force Stop؛unexpected_exception- حدث خطأ داخلي أثناء الزحف إلىtarget، تواصل مع الدعم لمزيد من المعلومات - domainالنوع: object | null · Response36Afe1097B20_DomainInfo
_info معلومات على مستوى النطاق
معلومات داخل الصفحة عن النطاق المستهدف وعملية الزحف- canonicalizationالنوع: integer | null
_status _code رمز الحالة الذي تعيده صفحة مُوحَّدة
فحص سلوك الخادم عندما يحاول الزاحف الوصول إلى الموقع عبر IP
في معظم الحالات، يُوصى بأن تعيد الصفحات المُوحَّدة رمز حالة301أو302 - checksالنوع: object | null
فحوص الموقع
فحوص أخرى داخل الصفحة تتعلق بالموقع- propertyالنوع: boolean | null
Name
- cmsالنوع: string | null
نظام إدارة المحتوى
نظام إدارة المحتوى المحدد على موقع
محتوى وسمgeneratorالتعريفي (meta)
تُؤخذ البيانات من أول صفحة عشوائية تعيد رمز الاستجابة 200
إذا تعذّر على الزاحف تحديد نظام إدارة المحتوى، فستكون القيمةnull - crawlالنوع: string | null
_end وقت انتهاء الزحف
تاريخ ووقت انتهاء الزحف
بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00
ملاحظة: للعلم فقط إذا كانت"crawl_progress"هي"finished"
إذا كانت"crawl_progress"هيin_progress، فستكون القيمةnull - crawlالنوع: string | null
_start وقت بدء الزحف
تاريخ ووقت إرسال الموقع للزحف
بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00 - directoryالنوع: integer | null
_browsing _status _code رمز الحالة الذي يعيده الدليل
رمز الحالة الذي تعيده صفحة دليل على موقع هدف
في معظم الحالات، يُوصى بأن تعيد الأدلة رمز حالة403أو401 - extendedالنوع: string | null
_crawl _status حالة الزحف والأخطاء
يشير إلى سبب عدم الزحف إلى موقع
يمكن أن يأخذ القيم التالية:no_errors- لم تُكتشف أخطاء زحفsite_unreachable- تعذّر على الزاحف الوصول إلى الموقع وبالتالي لم يتمكن من الحصول على رمز حالةinvalid_page_status_code- رمز حالة أول صفحة مزحوفة >= 400forbidden_meta_tag- تحتوي أول صفحة مزحوفة على وسم <meta robots="noindex">forbidden_robots- يمنع robots.txt الزحف إلى الصفحةforbidden_http_header- تحتوي ترويسة HTTP للصفحة على "X-Robots-Tag: noindex"too_many_redirects- تحتوي أول صفحة مزحوفة على أكثر من 10 إعادات توجيهunknown- السبب غير معروف - ipالنوع: string | null
عنوان IP للنطاق
- mainالنوع: string | null
_domain اسم النطاق الجذر
- nameالنوع: string | null
اسم النطاق
- pageالنوع: integer | null
_not _found _status _code رمز الحالة الذي تعيده صفحة غير موجودة
في معظم الحالات، يُوصى بأن يعيد الخادم رمز استجابة 404 - serverالنوع: string | null
خادم الموقع
إصدار الخادم المكتشف على موقع
محتوى ترويسةserver
تُؤخذ المعلومات من أول صفحة يكون رمز استجابتها 200 - sslالنوع: object | null · Response36Afe1097B20_SslInfo
_info معلومات شهادة SSL
معلومات حول بروتوكول طبقة المقابس الآمنة المكتشف على موقع- certificateالنوع: string | null
_expiration _date تاريخ انتهاء صلاحية شهادة SSL
التاريخ والوقت اللذان تنتهي فيهما صلاحية شهادة SSL
بالتنسيق: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00 - certificateالنوع: string | null
_hash تجزئة شهادة SSL
إصدار دالة التجزئة لشهادة SSL - certificateالنوع: string | null
_issuer جهة إصدار شهادة SSL
الكيان الذي أصدر شهادة SSL المكتشفة - certificateالنوع: string | null
_subject موضوع شهادة SSL
الكيان المرتبط بالمفتاح العام - certificateالنوع: integer | null
_version - validالنوع: boolean | null
_certificate صلاحية شهادة SSL
يشير إلى ما إذا كانت شهادة SSL المكتشفة على موقع ويب غير منتهية أو معلّقة أو ملغاة أو غير صالحة
- totalالنوع: integer | null التنسيق: int64
_pages إجمالي الصفحات المزحوفة
العدد الإجمالي للصفحات المزحوفة - totalالنوع: integer | null التنسيق: int64
_uncrawlable _resources إجمالي الموارد غير القابلة للزحف
العدد الإجمالي للموارد التي تعذّر الزحف إليها
يُعد المورد غير قابل للزحف عندما لا يطابق نوع المحتوى الفعلي للمورد نوع المحتوى المتوقع من الزاحف - wwwالنوع: integer | null
_redirect _status _code رمز حالة إعادة التوجيه
رمز حالة إعادة التوجيه من www إلى non-www
في معظم الحالات، يُوصى بأن تعيد إعادة التوجيه رمز حالة301
- pageالنوع: object | null · Response36Afe1097B20_PageMetrics
_metrics معلومات خاصة بالصفحة
معلومات المقاييس عن صفحات الموقع المستهدف- brokenالنوع: integer | null
_links عدد الروابط المعطّلة
عدد الروابط المعطّلة عبر جميع الصفحات التي جرى الزحف إليها في موقع مستهدف - brokenالنوع: integer | null
_resources عدد الموارد المعطّلة
عدد الصور والموارد الأخرى ذات الروابط المعطّلة - checksالنوع: object | null
فحوص داخل الصفحة خاصة بالصفحة
- propertyالنوع: integer | null التنسيق: int64
Name Signed 64-bit integers (long type).
- duplicateالنوع: integer | null
_content عدد الصفحات ذات المحتوى المكرر
- duplicateالنوع: integer | null
_description عدد الصفحات ذات الأوصاف المكررة
- duplicateالنوع: integer | null
_title عدد الصفحات ذات العناوين المكررة
- linksالنوع: integer | null
_external عدد الروابط الخارجية
عدد الروابط التي تشير إلى مواقع أخرى - linksالنوع: integer | null
_internal عدد الروابط الداخلية
عدد الروابط التي تشير إلى صفحات أخرى داخل الموقع المستهدف - linksالنوع: integer | null
_relation _conflict عدد الروابط الموجودة على الموقع المستهدف التي قد تكون متعارضة
مثلًا، إذا كانت"links_relation_conflict": 2، فإن الموقع المستهدف يشير إلى المصدر نفسه من خلال رابط داخلي واحد على الأقل يحمل السمةrel="nofollow"و رابط واحد على الأقل قابل للمتابعة (dofollow) - nonالنوع: integer | null
_indexable - onpageالنوع: number | null
_score يعرض مدى تحسين الموقع على مقياس من 100 نقطة
يعرض هذا الحقل مدى تحسين الموقع مع مراعاة المشكلات الحرجة والتحذيرات المكتشفة داخل الصفحة؛100هي أعلى درجة ممكنة وتعني أن الموقع لا يحتوي على مشكلات حرجة أو تحذيرات مهمة داخل الصفحة؛
ملاحظة أن هذه القيمة تعتمد على عدد الصفحات التي جرى الزحف إليها؛
اعرف المزيد عن كيفية حساب هذا المقياس في مقالة مركز المساعدة هذه - redirectالنوع: integer | null
_loop عدد سلاسل إعادة التوجيه التي تبدأ وتنتهي عند عنوان URL نفسه
عدد سلاسل إعادة التوجيه التي يعيد فيها عنوان URL الوجهة التوجيه إلى عنوان URL الأصلي
- 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/on_page/summary/00000000-0000-0000-0000-000000000000 \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"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": [
{
"crawl_progress": null,
"crawl_status": {
"max_crawl_pages": null,
"pages_in_queue": null,
"pages_crawled": null
},
"crawl_gateway_address": null,
"crawl_stop_reason": null,
"domain_info": {
"name": null,
"cms": null,
"ip": null,
"server": null,
"crawl_start": null,
"crawl_end": null,
"extended_crawl_status": null,
"ssl_info": "[Max Depth Exceeded]",
"checks": null,
"total_pages": null,
"total_uncrawlable_resources": null,
"page_not_found_status_code": null,
"canonicalization_status_code": null,
"directory_browsing_status_code": null,
"www_redirect_status_code": null,
"main_domain": null
},
"page_metrics": {
"links_external": null,
"links_internal": null,
"duplicate_title": null,
"duplicate_description": null,
"duplicate_content": null,
"broken_links": null,
"broken_resources": null,
"links_relation_conflict": null,
"redirect_loop": null,
"onpage_score": null,
"non_indexable": null,
"checks": null
}
}
]
}
]
}