Felo API PlatformFelo API Platform
جميع endpoints الخاصة بـ DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

الموارد غير القابلة للزحف

الخادم:https://openapi.felo.ai
مكتبات العملاء

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

الموارد غير القابلة للزحف

​

الموارد التي تعذّر على الزحف جلبها، والسبب. يعيد total_items_count وitems_count وitems. يقرأ زحفًا منتهيًا، لذا يحتاج id من post_dataforseo_on_page_submit ويعيد crawl_progress مع crawl_status من max_crawl_pages وpages_in_queue وpages_crawled — افحصها قبل الوثوق بنتيجة صغيرة، لأن الزحف الذي لا يزال جاريًا يبلّغ عن أقل فقط. هذه هي المراجع المعطوبة التي يريدها مالك الموقع أولًا؛ أما التي حُمّلت فعلًا فهي في post_dataforseo_on_page_resources. 💰 مجاني من المنبع: الاستعلام عن زحف منتهٍ لا يكلّف شيئًا، الزحف نفسه فقط.

مرجع التسعير

  • القياس: تكلفة الاستجابة المُبلَّغ عنها.
  • تقدير الطلب المرجعي: 0.012 دولار أمريكي.
  • مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.

بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.

الجسم
application/json
  • النوع: array (object | null)[]
    • filters
      النوع: array (object | null)[] | null

      مصفوفة معاملات تصفية النتائج
      حقل اختياري
      يمكنك إضافة عدة عوامل تصفية دفعة واحدة (8 عوامل كحد أقصى)
      يجب تعيين عامل منطقي and أو or بين الشروط
      العوامل التالية مدعومة:
      regex، not_regex، <، <=، >، >=، =، <>، in، not_in، like، not_like
      يمكنك استخدام العامل % مع like وnot_like لمطابقة أي سلسلة من صفر أو أكثر من الأحرف
      مثال:
      [["meta.content_type","=","image/jpeg"],
      "and",
      ["url","not_like","%/help-center/%"]]

      تتوفر القائمة الكاملة لعوامل التصفية الممكنة عبر هذا الرابط.

      كائن فارغ
    • id
      النوع: string

      معرّف المهمة
      حقل مطلوب
      يمكنك الحصول على هذا المعرّف في استجابة نقطة النهاية Task POST
      مثال:
      "07131248-1535-0216-1000-17384017ad04"

    • limit
      النوع: integer | null

      الحد الأقصى لعدد الموارد غير القابلة للزحف المعادة
      حقل اختياري
      القيمة الافتراضية: 100
      القيمة القصوى: 1000

    • offset
      النوع: integer | null

      الإزاحة في مصفوفة نتائج الموارد غير القابلة للزحف المعادة
      حقل اختياري
      القيمة الافتراضية: 0
      القيمة القصوى: 2000000
      إذا حددت القيمة 10، فسيُحذف أول عشرة موارد غير صالحة من مصفوفة النتائج وستُقدَّم البيانات للموارد غير الصالحة اللاحقة

    • order_by
      النوع: array string[] | null

      قواعد فرز النتائج
      حقل اختياري
      يمكنك استخدام القيم نفسها الموجودة في مصفوفة filters لفرز النتائج
      أنواع الفرز الممكنة:
      asc - تُفرز النتائج بترتيب تصاعدي
      desc - تُفرز النتائج بترتيب تنازلي
      استخدم فاصلة لتعيين نوع الفرز
      مثال:
      ["meta.content_type,desc"]
      لاحظ أنه لا يمكن تعيين أكثر من ثلاث قواعد فرز في طلب واحد
      استخدم فاصلة للفصل بين عدة قواعد فرز
      مثال:
      ["meta.content_type,asc","fetch_time,desc"]

الاستجابات
  • 200
    النوع: object | null · Response36Afe1097B20_OnPageUncrawlableResourcesResponseInfo
    • cost
      النوع: number | null التنسيق: double

      إجمالي تكلفة المهام، بالدولار الأمريكي

    • status_code
      النوع: integer | null

      رمز الحالة العام يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا

    • status_message
      النوع: string | null

      رسالة معلوماتية عامة يمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا

    • tasks
      النوع: array (object | null)[] | null

      مصفوفة المهام

      • النوع: object | null · Response36Afe1097B20_OnPageUncrawlableResourcesTaskInfo
        • cost
          النوع: number | null التنسيق: double

          إجمالي تكلفة المهام، بالدولار الأمريكي

        • data
          النوع: object | null

          يحتوي على المعاملات نفسها التي حددتها في طلب POST

          • propertyName
            النوع: object | null
        • id
          النوع: string | null

          معرّف المهمة معرّف مهمة فريد في نظامنا بصيغة UUID

        • path
          النوع: array (string | null)[] | null

          مسار URL

        • result
          النوع: array (object | null)[] | null

          مصفوفة نتائج

          • crawl_progress
            النوع: string | null

            حالة جلسة الزحف
            القيم الممكنة: in_progress، finished

          • crawl_status
            النوع: object | null · Response36Afe1097B20_CrawlStatusInfo

            تفاصيل جلسة الزحف

            • max_crawl_pages
              النوع: integer | null التنسيق: int64

              الحد الأقصى لعدد الصفحات المراد الزحف إليها يشير إلى حد max_crawl_pages الذي حددته عند إعداد المهمة

            • pages_crawled
              النوع: integer | null التنسيق: int64

              عدد الصفحات المزحوفة

            • pages_in_queue
              النوع: integer | null التنسيق: int64

              عدد الصفحات الموجودة حاليًا في قائمة انتظار الزحف

          • current_offset
            النوع: integer | null

            Integer numbers.

          • items
            النوع: array (object | null)[] | null

            مصفوفة الموارد غير القابلة للزحف

            • fetch_time
              النوع: string | null

              التاريخ والوقت الذي جرى فيه جلب المورد
              بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
              مثال:
              2026-03-09 18:20:32 +00:00

            • meta
              النوع: object | null · Response36Afe1097B20_UncrawlableResourcesMeta

              بيانات وصفية للمورد غير القابل للزحف

              • content_type
                النوع: string | null

                نوع المحتوى الفعلي للمورد

              • expected_content_types
                النوع: array (string | null)[] | null

                أنواع المحتوى المتوقعة للمورد
                قائمة أنواع المحتوى التي توقعها الزاحف استنادًا إلى كيفية الإشارة إلى المورد في الصفحة

            • reason
              النوع: string | null

              سبب عدم إمكانية الزحف إلى المورد
              يمكن أن يأخذ القيم التالية: content_type_inconsistency

            • status_code
              النوع: integer | null

              رمز الحالة العام
              يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا
              ملاحظة: نوصي بشدة بتصميم نظام ضروري لمعالجة الحالات الاستثنائية أو الأخطاء ذات الصلة

            • url
              النوع: string | null

              عنوان URL للمورد غير القابل للزحف

          • items_count
            النوع: integer | null التنسيق: int64

            عدد الموارد غير القابلة للزحف في مصفوفة items

          • total_items_count
            النوع: integer | null التنسيق: int64

            العدد الإجمالي للموارد غير القابلة للزحف التي عُثر عليها
            العدد الإجمالي للموارد غير القابلة للزحف التي عُثر عليها أثناء الزحف إلى النطاق المستهدف

        • result_count
          النوع: integer | null التنسيق: int64

          عدد العناصر في مصفوفة result

        • status_code
          النوع: integer | null

          رمز حالة المهمة ينشئه DataForSEO ويمكن أن يقع ضمن النطاق التالي: 10000-60000 يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا

        • status_message
          النوع: string | null

          الرسالة المعلوماتية للمهمة يمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا

        • time
          النوع: string | null

          وقت التنفيذ، بالثواني

    • tasks_count
      النوع: integer | null التنسيق: int64

      عدد المهام في مصفوفة tasks

    • tasks_error
      النوع: integer | null التنسيق: int64

      عدد المهام في مصفوفة tasks التي أُعيدت مع خطأ

    • time
      النوع: string | null

      إجمالي وقت التنفيذ، بالثواني

    • version
      النوع: string | null

      الإصدار الحالي من API

    application/json
  • 400

    تعذّرت معالجة الطلب. تحقق من معاملات الطلب.

  • 401

    مطلوب مفتاح API صالح من Felo.

  • 402

    لا يمكن متابعة الطلب لأن أحد متطلبات الفوترة غير مستوفٍ.

  • 403

    الحساب غير مصرّح له بهذه العملية.

  • 429

    تم بلوغ حد الطلبات أو حد الإنفاق.

  • 502

    تعذّر على الخدمة إكمال الطلب.

  • 503

    خدمة API أو الفوترة غير متاحة مؤقتًا.

  • 504

    انتهت مهلة الخدمة أثناء معالجة الطلب.

  • default

    استجابة خطأ؛ قد تستخدم استجابات المنبع الممرَّرة تنسيقات المزوّد

    application/json
Request Example for post/v1/beta/dataforseo/on_page/uncrawlable_resources
curl https://openapi.felo.ai/v1/beta/dataforseo/on_page/uncrawlable_resources \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "id": "07281559-0695-0216-0000-c269be8b7592",
    "filters": [
      [
        "meta.content_type",
        "=",
        "image/jpeg"
      ],
      "and",
      [
        "url",
        "like",
        "%go%"
      ]
    ],
    "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
          },
          "current_offset": null,
          "total_items_count": null,
          "items_count": null,
          "items": [
            {
              "url": null,
              "reason": null,
              "status_code": null,
              "fetch_time": null,
              "meta": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}
Uncrawlable Resources