Felo API PlatformFelo API Platform
همه endpointهای DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Google Ai Mode SERP HTML زنده

Felo API Support
MIT
سرور:https://openapi.felo.ai
کتابخانه‌های کلاینت
Shell Curl

DataForSEO

​

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

DataForSEO عملیات

Google Ai Mode SERP HTML زنده

​

پاسخ Google AI Mode را برای یک پرس‌وجو، همراه با منابعی که در Google به آن‌ها استناد می‌کند، به‌صورت همگام برمی‌گرداند. منبع صفحه خام به‌جای نتایج تجزیه‌شده. پاسخ در پاکت DataForSEO قرار می‌گیرد: داده‌ها در tasks[0].result و نتیجه در tasks[0].status_code — درخواست ردشده نیز همچنان HTTP 200 برمی‌گرداند.

مرجع قیمت‌گذاری

  • اندازه‌گیری: هزینه گزارش‌شده پاسخ.
  • برآورد درخواست مرجع: 0.02 دلار آمریکا.
  • ضریب مشتری مرجع: 1.0. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.

فقط فراداده مرجع است، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.

بدنه
application/json
  • نوع: array (object | null)[]
    • device
      نوع: string | null

      نوع دستگاه
      فیلد اختیاری
      برگرداندن نتایج برای نوع دستگاه مشخص
      می‌تواند مقادیر زیر را داشته باشد:desktop، mobile
      مقدار پیش‌فرض: desktop

    • keyword
      نوع: string

      کلمه کلیدی
      فیلد الزامی
      می‌توانید حداکثر 700 کاراکتر در فیلد keyword مشخص کنید
      همه %## رمزگشایی می‌شوند (کاراکتر '+' به فاصله رمزگشایی می‌شود)
      اگر باید از کاراکتر "%" برای keyword استفاده کنید، آن را به‌صورت "%25" مشخص کنید؛
      اگر باید از کاراکتر "+" برای keyword استفاده کنید، آن را به‌صورت "%2B" مشخص کنید؛

    • language_code
      نوع: string

      کد زبان موتور جستجو
      فیلد الزامی اگر language_name را مشخص نکنید؛
      اگر از این فیلد استفاده کنید، نیازی به مشخص کردن language_name ندارید؛
      می‌توانید فهرست زبان‌های موجود موتور جستجو را همراه با language_code آن‌ها با ارسال درخواستی جداگانه به https://api.dataforseo.com/v3/serp/google/ai_mode/languages دریافت کنید

    • language_name
      نوع: string

      نام کامل زبان موتور جستجو
      فیلد الزامی اگر language_code را مشخص نکنید؛
      اگر از این فیلد استفاده کنید، نیازی به مشخص کردن language_code ندارید؛
      می‌توانید فهرست زبان‌های موجود موتور جستجو را همراه با language_name آن‌ها با ارسال درخواستی جداگانه به https://api.dataforseo.com/v3/serp/google/ai_mode/languages دریافت کنید؛

    • location_code
      نوع: integer

      کد موقعیت موتور جستجو
      فیلد الزامی اگر location_name یا location_coordinate را مشخص نکنید
      اگر از این فیلد استفاده کنید، نیازی به مشخص کردن location_name یا location_coordinate ندارید
      می‌توانید فهرست موقعیت‌های موجود موتورهای جستجو را همراه با location_code آن‌ها با ارسال درخواستی جداگانه به https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations دریافت کنید
      مثال:
      2840

    • location_coordinate
      نوع: string

      مختصات GPS یک موقعیت
      فیلد الزامی اگر تعیین نکنید location_name یا location_code
      در صورت استفاده از این فیلد، نیازی به تعیین location_name یا location_code نیست
      پارامتر location_coordinate باید در قالب "latitude,longitude,radius" تعیین شود
      حداکثر تعداد ارقام اعشاری برای "latitude" و "longitude": 7
      حداقل مقدار برای "radius": 199.9 (میلی‌متر)
      حداکثر مقدار برای "radius": 199999 (میلی‌متر)
      مثال:
      53.476225,-2.243572,200

    • location_name
      نوع: string

      نام کامل موقعیت موتور جستجو
      فیلد الزامی اگر location_code یا location_coordinate را مشخص نکنید
      اگر از این فیلد استفاده کنید، نیازی به مشخص کردن location_code یا location_coordinate ندارید
      می‌توانید فهرست موقعیت‌های موجود موتور جستجو را همراه با location_name آن‌ها با ارسال درخواستی جداگانه به https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations دریافت کنید
      مثال:
      London,England,United Kingdom

    • os
      نوع: string | null

      سیستم‌عامل دستگاه
      فیلد اختیاری
      اگر desktop را در فیلد device مشخص کنید، از مقادیر زیر انتخاب کنید: windows، macos
      مقدار پیش‌فرض: windows
      اگر mobile را در فیلد device مشخص کنید، از مقادیر زیر انتخاب کنید: android، ios
      مقدار پیش‌فرض: android

    • tag
      نوع: string | null

      شناسه وظیفه تعریف‌شده توسط کاربر
      فیلد اختیاری
      محدودیت کاراکتر 255 است
      می‌توانید از این پارامتر برای شناسایی وظیفه و تطبیق آن با نتیجه استفاده کنید
      مقدار tag مشخص‌شده را در شیء data پاسخ پیدا می‌کنید

پاسخ‌ها
  • 200
    نوع: object | null · Response36Afe1097B20_SerpGoogleAiModeLiveHtmlResponseInfo
    • cost
      نوع: number | null قالب: double

      هزینه کل وظایف، دلار آمریکا

    • status_code
      نوع: integer | null

      کد وضعیت عمومی فهرست کامل کدهای پاسخ را اینجا پیدا می‌کنید

    • status_message
      نوع: string | null

      پیام اطلاعاتی عمومی فهرست کامل پیام‌های اطلاعاتی عمومی را اینجا پیدا می‌کنید

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

      آرایه‌ای از وظایف

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

          آرایه‌ای از نتایج

          • datetime
            نوع: string | null

            تاریخ و زمانی که نتیجه دریافت شده است
            در قالب UTC: “yyyy-mm-dd hh-mm-ss +00:00”
            مثال:
            2019-11-15 12:57:46 +00:00

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

            عناصر نتایج جستجوی یافت‌شده در SERP

            • date
              نوع: string | null

              تاریخ و زمان اسکن صفحه HTML
              با قالب UTC: “yyyy-mm-dd hh-mm-ss +00:00”
              مثال:
              2019-11-15 12:57:46 +00:00

            • html
              نوع: string | null

              صفحه HTML

            • page
              نوع: integer | null

              شماره سریال صفحه HTML بازگردانده‌شده

          • items_count
            نوع: integer | null قالب: int64

            تعداد نتایج بازگردانده‌شده در آرایه items

          • keyword
            نوع: string | null

            کلیدواژه دریافت‌شده در آرایه POST
            کلیدواژه با کدگشایی %## برگردانده می‌شود (کاراکتر '+' به فاصله کدگشایی می‌شود)

          • language_code
            نوع: string | null

            کد زبان در آرایه POST

          • location_code
            نوع: integer | null

            کد مکان در آرایه POST

          • se_domain
            نوع: string | null

            دامنه موتور جستجو در آرایه POST

          • type
            نوع: string | null

            نوع عنصر

        • 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/google/ai_mode/live/html
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/ai_mode/live/html \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "albert einstein"
  }
]'

{
  "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": [
        {
          "keyword": null,
          "type": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "datetime": null,
          "items_count": null,
          "items": [
            {
              "page": null,
              "date": null,
              "html": null
            }
          ]
        }
      ]
    }
  ]
}

عملیات موفق

Live Google Ai Mode SERP HTML