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

لقطة شاشة صفحة SERP API

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

DataForSEO

​

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

DataForSEO العمليات

لقطة شاشة صفحة SERP API

​

يعيد لقطة شاشة مُصيَّرة لصفحة نتائج بحث على Google. يعيد keyword وtype وse_domain وlocation_code وlanguage_code وcheck_url وdatetime وspell وrefinement_chips وitem_types وitems_count وitems. الاستجابة مغلّفة في غلاف DataForSEO: البيانات في tasks[0].result، والنتيجة في tasks[0].status_code — ولا يزال الطلب المرفوض يعيد HTTP 200.

مرجع التسعير

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

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

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

      إعداد مسبق لدقة المتصفح
      حقل اختياري
      إعداد مسبق للمتصفح مرتبط بنوع جهاز معين
      يمكن أن تأخذ القيم التالية: desktop، tablet، mobile
      ملاحظة: افتراضيًا، يتوافق إعداد المتصفح المسبق مع نوع الجهاز المحدد في طلب POST

    • browser_screen_height
      النوع: integer | null

      ارتفاع دقة المتصفح
      حقل اختياري
      يمكن تحديده في النطاق التالي: 240-9999
      القيمة الافتراضية لـdesktop: 1080
      القيمة الافتراضية لـmobile: 844
      القيمة الافتراضية لـtable: 1366

    • browser_screen_scale_factor
      النوع: number | null

      عامل تحجيم المتصفح
      حقل اختياري
      يمكن تحديده في النطاق التالي: 0.5-3
      القيمة الافتراضية لـdesktop: 1
      القيمة الافتراضية لـmobile: 3
      القيمة الافتراضية لـtable: 2

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

      عرض دقة المتصفح
      حقل اختياري
      يمكن تحديده في النطاق التالي: 240-9999
      القيمة الافتراضية لـdesktop: 1920
      القيمة الافتراضية لـmobile: 390
      القيمة الافتراضية لـtable: 1024

    • page
      النوع: integer | null

      عدد صفحات SERP
      حقل اختياري
      إذا تجاوز depth في طلب Task POST المقابل 10 نتائج (أو صفحة SERP واحدة)، فحدد عدد صفحات SERP المراد التقاط لقطات لها
      القيمة الافتراضية: 1

    • task_id
      النوع: string

      معرّف المهمة
      حقل مطلوب
      معرّف فريد للمهمة المرتبطة بصيغة UUID
      ستتمكن من استخدامه خلال 7 أيام لطلب نتائج المهمة في أي وقت

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

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

    • status_code
      النوع: integer | null

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

    • status_message
      النوع: string | null

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

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

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

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

          مصفوفة نتائج

          • 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/serp/screenshot
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/screenshot \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "task_id": "06211235-0696-0139-1000-36727fbd3c90",
    "browser_screen_scale_factor": 0.5
  }
]'

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

عملية ناجحة

SERP API Page Screenshot