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

لقطة شاشة الصفحة في OnPage API

Felo API Support
MIT
الخادم:https://openapi.felo.ai
مكتبات العملاء
Shell Curl

DataForSEO

​

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

DataForSEO العمليات

لقطة شاشة الصفحة في OnPage API

​

يعرض أي url ويعيد لقطة شاشة، مع full_page_screenshot لكامل ارتفاع التمرير وbrowser_screen_width وbrowser_screen_height لضبط منفذ العرض. مستقل — لا يلزم زحف. الاستجابة مغلّفة في غلاف DataForSEO: البيانات في tasks[0].result، والنتيجة في tasks[0].status_code — ولا يزال الطلب المرفوض يعيد HTTP 200. ⚠️ الصورة نتيجة أداة كبيرة حتى قبل أن يتمكّن الوكيل من فعل أي شيء بها؛ اطلب لقطة شاشة فقط عندما يكون العرض البصري هو المقصود، واستخدم post_dataforseo_on_page_content_parsing_live عندما يكون النص هو المقصود.

مرجع التسعير

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

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

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

      ترويسة اللغة للوصول إلى الموقع
      حقل اختياري
      جميع صيغ اللغة مدعومة (xx، xx-XX، xxx-XX، إلخ.)
      ملاحظة: إذا لم تحدد هذا المعامل، فقد ترفض بعض المواقع الوصول؛ في هذه الحالة، ستحصل على "error_message":"Screenshot is empty" في مصفوفة الاستجابة

    • browser_preset
      النوع: string | null

      إعداد مسبق لمعاملات شاشة المتصفح
      حقل اختياري
      إذا استخدمت هذا الحقل، فلن تحتاج إلى تحديد browser_screen_width أو browser_screen_height أو browser_screen_scale_factor

      القيم الممكنة:
      desktop، mobile، tablet

      الإعداد المسبق desktop سيطبّق القيم التالية:

      browser_screen_width: 1920
      browser_screen_height: 1080
      browser_screen_scale_factor: 1

      الإعداد المسبق mobile سيطبّق القيم التالية:

      browser_screen_width: 390
      browser_screen_height: 844
      browser_screen_scale_factor: 3

      الإعداد المسبق tablet سيطبّق القيم التالية:

      browser_screen_width: 1024
      browser_screen_height: 1366
      browser_screen_scale_factor: 2

      ملاحظة: في نقطة النهاية هذه، تكون المعاملات enable_browser_rendering وenable_javascript وload_resources وenable_xhr مفعّلة دائمًا.

    • browser_screen_height
      النوع: integer | null

      ارتفاع شاشة المتصفح
      حقل اختياري
      يمكنك تعيين ارتفاع مخصص لشاشة المتصفح لإجراء التدقيق لجهاز معيّن؛
      إذا استخدمت هذا الحقل، فلن تحتاج إلى تحديد browser_preset لأنه سيُتجاهل؛

      الحد الأدنى، بالبكسل: 240
      الحد الأقصى، بالبكسل: 9999

    • browser_screen_scale_factor
      النوع: number | null

      عامل تحجيم شاشة المتصفح
      حقل اختياري
      يمكنك تعيين نسبة دقة مخصصة لشاشة المتصفح لإجراء التدقيق لجهاز معيّن؛
      إذا استخدمت هذا الحقل، فلن تحتاج إلى تحديد browser_preset لأنه سيُتجاهل؛

      الحد الأدنى: 0.5
      الحد الأقصى: 3

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

      عرض شاشة المتصفح
      حقل اختياري
      يمكنك تعيين عرض مخصص لشاشة المتصفح لإجراء التدقيق لجهاز معيّن؛
      إذا استخدمت هذا الحقل، فلن تحتاج إلى تحديد browser_preset لأنه سيُتجاهل؛

      الحد الأدنى، بالبكسل: 240
      الحد الأقصى، بالبكسل: 9999

    • custom_user_agent
      النوع: string | null

      وكيل مستخدم مخصص
      حقل اختياري
      وكيل مستخدم مخصص لزحف موقع ويب
      مثال: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.116 Safari/537.36

      القيمة الافتراضية: Mozilla/5.0 (compatible; RSiteAuditor)

    • disable_cookie_popup
      النوع: boolean | null

      تعطيل النافذة المنبثقة لملفات تعريف الارتباط
      حقل اختياري
      عيّن على true إذا أردت تعطيل النافذة المنبثقة التي تطلب موافقة المستخدم على ملفات تعريف الارتباط؛
      القيمة الافتراضية:
      false

    • full_page_screenshot
      النوع: boolean | null

      التقاط لقطة شاشة للصفحة كاملة
      حقل اختياري
      عيّن على false إذا أردت التقاط الجزء الظاهر من الصفحة فقط قبل التمرير
      القيمة الافتراضية: true

    • ip_pool_for_scan
      النوع: string | null

      مجموعة البروكسي
      حقل اختياري
      يمكنك اختيار موقع مجموعة البروكسي التي ستُستخدم للحصول على البيانات المطلوبة؛
      يمكن استخدام المعامل إذا كان محتوى الصفحة غير متاح في أحد المواقع، ما يؤدي إلى أخطاء site_unreachable متفرقة
      القيم الممكنة: us، de

    • switch_pool
      النوع: boolean | null

      التبديل بين مجموعات البروكسي
      حقل اختياري
      إذا كانت القيمة true، فستُستخدم مجموعات بروكسي إضافية للحصول على البيانات المطلوبة؛
      يمكن استخدام المعامل إذا تم تعيين عدد كبير من المهام في الوقت نفسه، ما يؤدي إلى أخطاء rate-limit و/أو site_unreachable متفرقة

    • url
      النوع: string

      عنوان URL للصفحة
      حقل مطلوب
      عنوان URL المطلق للصفحة المراد التقاطها
      ملاحظة: إذا أعاد عنوان URL الذي تشير إليه هنا رمز الحالة 404 أو كانت القيمة المحددة ليست عنوان URL صالحًا، فستحصل على "error_message":"Screenshot is empty" في مصفوفة الاستجابة

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

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

    • status_code
      النوع: integer | null

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

    • status_message
      النوع: string | null

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

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

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

      • النوع: object | null · Response36Afe1097B20_OnPagePageScreenshotTaskInfo
        • 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

          • error_message
            النوع: string | null

            رسالة الخطأ
            إذا أعاد url الذي حددته رمز الحالة 404 أو لم يكن عنوان URL صالحًا، فستحصل على "error_message":"Screenshot is empty"
            إذا لم يحدث خطأ، ستكون القيمة null

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

            مصفوفة العناصر

            • image
              النوع: string | null

              لقطة شاشة للصفحة المطلوبة
              عنوان URL للقطة شاشة الصفحة على تخزين DataForSEO
              ملاحظة: تظل لقطة شاشة الصفحة المحفوظة على تخزين DataForSEO متاحة ليوم واحد فقط بعد إجراء الطلب

          • 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/page_screenshot
curl https://openapi.felo.ai/v1/beta/dataforseo/on_page/page_screenshot \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "url": "https://dataforseo.com/apis"
  }
]'

{
  "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,
          "error_message": null,
          "items_count": null,
          "items": [
            {
              "image": null
            }
          ]
        }
      ]
    }
  ]
}

عملية ناجحة

OnPage API Page Screenshot