Felo API PlatformFelo API Platform
v0.1.0-beta
OpenAPI 3.1.0

Get Google AI Mode SERP Advanced Results by id

Felo API Support
MIT
サーバー:https://openapi.felo.ai
クライアントライブラリ
Shell Curl

DataForSEO

​

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

DataForSEO 操作

Get Google AI Mode SERP Advanced Results by id

​

Retrieves a queued Google ai mode result by id. Returns keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count and items. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200.

パスパラメーター
  • id
    型: string
    必須

    Task identifier in UUID format

レスポンス
  • 200
    型: object

    Successful response

    • cost
      型: number

      Total tasks cost, USD

    • status_code
      型: integer

      General status code

    • status_message
      型: string

      General informational message

    • tasks
      型: array string[]

      Array of tasks

    • tasks_count
      型: integer

      The number of tasks in the tasks array

    • tasks_error
      型: integer

      The number of tasks in the tasks array returned with an error

    • tasks[].cost
      型: number

      Cost of the task, USD

    • tasks[].data
      型: object

      Contains the same parameters specified in the POST request

    • tasks[].id
      型: string

      Task identifier

    • tasks[].path
      型: array string[]

      URL path

    • tasks[].result
      型: array string[]

      Array of SERP results

    • tasks[].result_count
      型: integer

      Number of elements in the result array

    • tasks[].result[].check_url
      型: string

      Search URL with refinement parameters

    • tasks[].result[].item_types
      型: array string[]

      Types of search results found in SERP

    • tasks[].result[].items
      型: array string[]

      Elements of search results found in SERP

    • tasks[].result[].items_count
      型: integer

      Number of results returned in the items array

    • tasks[].result[].items[].markdown
      型: string

      Content of the element in markdown format

    • tasks[].result[].items[].type
      型: string

      Type of element, such as ai_overview

    • tasks[].result[].keyword
      型: string

      Keyword received in the POST array

    • tasks[].result[].se_results_count
      型: integer

      Total number of results in SERP

    • tasks[].result[].type
      型: string

      Search engine type in the POST array

    • tasks[].status_code
      型: integer

      Task status code

    • tasks[].status_message
      型: string

      Task status message

    • tasks[].time
      型: string

      Execution time, seconds

    • time
      型: string

      Execution time, seconds

    • version
      型: string

      The current version of the API

    application/json
  • 400

    Bad request

  • 401

    Unauthorized

  • 402

    The request cannot proceed because a billing requirement is not met.

  • 403

    The account is not permitted to perform this operation.

  • 429

    Rate limit exceeded

  • 500

    Internal server error

  • 502

    The service could not complete the request.

  • 503

    The API or billing service is temporarily unavailable.

  • 504

    The service timed out while processing the request.

  • default

    The operation failed. Keep the response request ID when contacting Felo support.

Request Example for get/v1/beta/dataforseo/serp/google/ai_mode/task_get/advanced/{id}
curl 'https://openapi.felo.ai/v1/beta/dataforseo/serp/google/ai_mode/task_get/advanced/{id}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "version": "string",
  "status_code": 1,
  "status_message": "string",
  "time": "string",
  "cost": 1,
  "tasks_count": 1,
  "tasks_error": 1,
  "tasks": [
    "string"
  ],
  "tasks[].id": "string",
  "tasks[].status_code": 1,
  "tasks[].status_message": "string",
  "tasks[].time": "string",
  "tasks[].cost": 1,
  "tasks[].result_count": 1,
  "tasks[].path": [
    "string"
  ],
  "tasks[].data": {},
  "tasks[].result": [
    "string"
  ],
  "tasks[].result[].keyword": "string",
  "tasks[].result[].type": "string",
  "tasks[].result[].check_url": "string",
  "tasks[].result[].item_types": [
    "string"
  ],
  "tasks[].result[].se_results_count": 1,
  "tasks[].result[].items_count": 1,
  "tasks[].result[].items": [
    "string"
  ],
  "tasks[].result[].items[].type": "string",
  "tasks[].result[].items[].markdown": "string"
}

Successful response

Get Google AI Mode SERP Advanced Results by id