DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
الموارد في OnPage API
الأصول غير الصفحية التي وجدها الزحف — صور ونصوص برمجية وأوراق أنماط — مع رموز حالتها وأحجامها. صفحات بـsearch_after_token. يقرأ زحفًا منتهيًا، لذا يحتاج id من post_dataforseo_on_page_submit ويعيد crawl_progress مع crawl_status من max_crawl_pages وpages_in_queue وpages_crawled — افحصها قبل الوثوق بنتيجة صغيرة، لأن الزحف الذي لا يزال جاريًا يبلّغ عن أقل فقط. للأصول التي تعذّر على الزاحف الوصول إليها إطلاقًا استخدم post_dataforseo_on_page_uncrawlable_resources. 💰 مجاني من المنبع: الاستعلام عن زحف منتهٍ لا يكلّف شيئًا، الزحف نفسه فقط.
مرجع التسعير
- القياس: تكلفة الاستجابة المُبلَّغ عنها.
- تقدير الطلب المرجعي: 0.012 دولار أمريكي.
- مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.
بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.
- النوع: array (object | null)[]
- filtersالنوع: array (object | null)[] | null
مصفوفة معاملات تصفية النتائج
حقل اختياري
يمكنك إضافة عدة عوامل تصفية دفعةً واحدة (8 كحد أقصى)
يجب تعيين معامل منطقيandأوorبين الشروط
المعاملات المدعومة:regex،not_regex،<،<=،>،>=،=،<>،in،not_in،like،not_like
يمكنك استخدام المعامل%معlikeوnot_likeلمطابقة أي سلسلة من صفر أو أكثر من الأحرف
مثال:["resource_type","=","stylesheet"][["resource_type","=","image"],
"and",["checks.is_https","=",false]][["fetch_timing.duration_time",">",1],"and",[["total_transfer_size",">",100],"or",["checks.high_loading_time","=",true]]]تتوفر القائمة الكاملة لعوامل التصفية الممكنة عبر هذا الرابط.
كائن فارغ - idالنوع: string
- limitالنوع: integer | null
الحد الأقصى لعدد الموارد المعادة
حقل اختياري
القيمة الافتراضية:100
الحد الأقصى:1000 - offsetالنوع: integer | null
الإزاحة في مصفوفة نتائج الموارد المعادة
حقل اختياري
القيمة الافتراضية:0
الحد الأقصى:2000000
إذا حددت القيمة10، فسيُحذف أول عشرة موارد من مصفوفة النتائج وستُقدَّم البيانات للموارد التالية - orderالنوع: array string[] | null
_by قواعد فرز النتائج
حقل اختياري
يمكنك استخدام القيم نفسها الموجودة في مصفوفةfiltersلفرز النتائج
أنواع الفرز الممكنة:asc- ستُفرز النتائج بترتيب تصاعديdesc- ستُفرز النتائج بترتيب تنازلي
يجب استخدام فاصلة لتعيين نوع الفرز
مثال:["size,desc"]
لاحظ أنه لا يمكنك تعيين أكثر من ثلاث قواعد فرز في طلب واحد
يجب استخدام فاصلة للفصل بين عدة قواعد فرز
مثال:["size,desc","fetch_timing.fetch_end,desc"] - relevantالنوع: array string[] | null
_pages _filters تصفية الموارد حسب الصفحات ذات الصلة
حقل اختياري
يمكنك استخدام هذا الحقل للحصول على موارد من صفحات تطابق المعاملات المحددة
يمكنك تطبيق عوامل التصفية نفسها المتاحة في نقطة النهاية pages
يمكنك إضافة عدة عوامل تصفية دفعةً واحدة (8 كحد أقصى)
يجب تعيين معامل منطقيandأوorبين الشروط
المعاملات المدعومة:regex،not_regex،<،<=،>،>=،=،<>،in،not_in،like،not_like
يمكنك استخدام المعامل%معlikeوnot_likeلمطابقة أي سلسلة من صفر أو أكثر من الأحرف
مثال:["checks.no_image_title","=",true] - searchالنوع: string | null
_after _token رمز للطلبات اللاحقة
حقل اختياري
يُقدَّم في الحقل المماثل في استجابة كل طلب؛
استخدم هذا المعامل لتجنب مهل الانتظار عند محاولة الحصول على أكثر من20,000نتيجة في طلب واحد؛
وبتحديد قيمةsearch_after_tokenالفريدة من مصفوفة الاستجابة، ستحصل على النتائج اللاحقة للمهمة الأولية؛
قيمsearch_after_tokenفريدة لكل مهمة لاحقة؛
ملاحظة: إذا حُددsearch_after_tokenفي الطلب، فيجب أن تكون جميع المعاملات الأخرى مطابقة للطلب السابق - tagالنوع: string | null
معرّف مهمة يحدده المستخدم
حقل اختياري
الحد الأقصى للأحرف هو 255
يمكنك استخدام هذا المعامل لتمييز المهمة ومطابقتها مع النتيجة
ستجد قيمةtagالمحددة في كائنdataضمن الاستجابة - urlالنوع: string | null
عنوان URL للصفحة
حقل اختياري
حدد هذا الحقل إذا أردت الحصول على موارد صفحة معيّنة
لاحظ أنه للحصول علىmetaالمورد من عنوان URL معيّن، يجب تحديد عنوان URL في هذا الحقل؛
إذا لم تحددurlعند تعيين مهمة، فسيُعادmetaالمورد في النتائج استنادًا إلى بيانات الصفحة التي شاهد فيها الزاحف المورد لأول مرة
- النوع: object | null · Response36Afe1097B20_OnPageResourcesResponseInfo200
- النوع: number | null التنسيق: doublecost
إجمالي تكلفة المهام، بالدولار الأمريكي
- النوع: integer | nullstatus
_code رمز الحالة العام يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا
- النوع: string | nullstatus
_message رسالة معلوماتية عامة يمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا
- النوع: array (object | null)[] | nulltasks
مصفوفة المهام
- النوع: object | null · Response36Afe1097B20_OnPageResourcesTaskInfo
- 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
_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 عدد الصفحات الموجودة حاليًا في قائمة انتظار الزحف
- currentالنوع: integer | null
_offset Integer numbers.
- itemsالنوع: array (object | null)[] | null
مصفوفة العناصر
- cacheالنوع: object | null · Response36Afe1097B20_CacheControl
_control تعليمات التخزين المؤقت
- cachableالنوع: boolean | null
تشير إلى ما إذا كانت الصفحة قابلة للتخزين المؤقت
- ttlالنوع: integer | null
مدة البقاء: مقدار الوقت الذي يخزّن فيه المتصفح موردًا مؤقتًا
- checksالنوع: object | null
فحوصات الموقع: فحوصات داخل الصفحة تتعلق بالصفحة
- propertyالنوع: boolean | null
Name
- contentالنوع: string | null
_encoding نوع الترميز
- encodedالنوع: integer | null
_size حجم الصفحة بعد الترميز: يشير إلى حجم الصفحة المرمّزة مقاسًا بالبايت
- fetchالنوع: string | null
_time التاريخ والوقت اللذان جُلبت فيهما إحدى الموارد بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”. مثال: 2019-11-15 12:57:46 +00:00
- lastالنوع: object | null · Response36Afe1097B20_LastModified
_modified يحتوي على بيانات حول التغييرات المتعلقة بالمورد. إذا لم توجد بيانات، ستكون القيمة null
- headerالنوع: string | null
التاريخ والوقت اللذان عُدّلت فيهما الترويسة آخر مرة بتنسيق UTC: "yyyy-mm-dd hh-mm-ss +00:00" مثال: 2019-11-15 12:57:46 +00:00 إذا لم تكن هناك بيانات، ستكون القيمة null
- metaالنوع: string | null
_tag التاريخ والوقت اللذان عُدّلت فيهما العلامة الوصفية آخر مرة بتنسيق UTC: "yyyy-mm-dd hh-mm-ss +00:00" مثال: 2019-11-15 12:57:46 +00:00 إذا لم تكن هناك بيانات، ستكون القيمة null
- sitemapالنوع: string | null
التاريخ والوقت اللذان عُدّل فيهما خريطة الموقع آخر مرة بتنسيق UTC: "yyyy-mm-dd hh-mm-ss +00:00" مثال: 2019-11-15 12:57:46 +00:00 إذا لم تكن هناك بيانات، ستكون القيمة null
- locationالنوع: string | null
ترويسة الموقع: تشير إلى عنوان URL الذي تُعاد توجيه الصفحة إليه
- mediaالنوع: string | null
_type أنواع الوسائط المستخدمة لعرض الصفحة
- resourceالنوع: object | null · Response36Afe1097B20_OnPageResourceIssueInfo
_errors أخطاء المورد وتحذيراته
- errorsالنوع: array (object | null)[] | null
أخطاء الموارد
- columnالنوع: integer | null
العمود الذي وُجد فيه الخطأ
- lineالنوع: integer | null
السطر الذي وُجد فيه الخطأ
- messageالنوع: string | null
رسالة نصية للخطأيمكن العثور على القائمة الكاملة لأخطاء HTML المحتملة هنا
- statusالنوع: integer | null
_code رمز الحالة العام: يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا. ملاحظة: نوصي بشدة بتصميم نظام لازم لمعالجة الحالات الاستثنائية أو حالات الخطأ ذات الصلة
- warningsالنوع: array (object | null)[] | null
تحذيرات الموارد
- columnالنوع: integer | null
العمود الذي وُجد فيه الخطأ
- lineالنوع: integer | null
السطر الذي وُجد فيه الخطأ
- messageالنوع: string | null
رسالة نصية للخطأيمكن العثور على القائمة الكاملة لأخطاء HTML المحتملة هنا
- statusالنوع: integer | null
_code رمز الحالة العام: يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا. ملاحظة: نوصي بشدة بتصميم نظام لازم لمعالجة الحالات الاستثنائية أو حالات الخطأ ذات الصلة
- resourceالنوع: string | null
_type نوع العنصر
- serverالنوع: string | null
إصدار الخادم
- sizeالنوع: integer | null
حجم المورد: يشير إلى حجم صفحة معيّنة مقاسًا بالبايت
- statusالنوع: integer | null
_code رمز الحالة العام: يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا. ملاحظة: نوصي بشدة بتصميم نظام لازم لمعالجة الحالات الاستثنائية أو حالات الخطأ ذات الصلة
- totalالنوع: integer | null التنسيق: int64
_transfer _size حجم الصفحة المضغوطة: يشير إلى الحجم المضغوط لصفحة معيّنة
- urlالنوع: string | null
عنوان URL للصفحة
- itemsالنوع: integer | null التنسيق: int64
_count عدد العناصر في مصفوفة النتائج
- searchالنوع: string | null
_after _token - totalالنوع: integer | null التنسيق: int64
_items _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/on_page/resources \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"id": "07281559-0695-0216-0000-c269be8b7592",
"filters": [
[
"resource_type",
"=",
"image"
],
"and",
[
"size",
">",
100000
]
],
"order_by": [
"size,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": [
{
"crawl_progress": null,
"crawl_status": {
"max_crawl_pages": null,
"pages_in_queue": null,
"pages_crawled": null
},
"search_after_token": null,
"current_offset": null,
"total_items_count": null,
"items_count": null,
"items": [
{
"resource_type": null,
"status_code": null,
"location": null,
"url": null,
"resource_errors": "[Max Depth Exceeded]",
"size": null,
"encoded_size": null,
"total_transfer_size": null,
"fetch_time": null,
"cache_control": "[Max Depth Exceeded]",
"checks": null,
"content_encoding": null,
"media_type": null,
"server": null,
"last_modified": "[Max Depth Exceeded]"
}
]
}
]
}
]
}