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

Live Google AI Mode SERP

Felo API Support
MIT
Server:https://openapi.felo.ai
Client Libraries
Shell Curl

DataForSEO

​

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

DataForSEO Operations

Live Google AI Mode SERP

​

Returns Google's AI Mode answer for a query, with the sources it cites on Google, synchronously. Returns keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count and items. advanced is the default choice; take regular when only the ranked list matters and html only to check what the parser dropped. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200.

Body
required
application/json
  • Type: array object[]
    • keyword
      Type: string
      required

      Keyword; you can specify up to 700 characters

    • browser_screen_height
      Type: integer

      Custom browser screen height

    • browser_screen_resolution_ratio
      Type: number

      Screen resolution ratio for rectangle calculations

    • browser_screen_width
      Type: integer

      Custom browser screen width

    • calculate_rectangles
      Type: boolean

      Enable pixel ranking calculations for elements in SERP

    • device
      Type: string

      Device type: desktop or mobile

    • language_code
      Type: string

      Search engine language code; required if language_name is not specified

    • language_name
      Type: string

      Full name of search engine language; required if language_code is not specified

    • location_code
      Type: integer

      Search engine location code; required if location_name or location_coordinate is not specified

    • location_coordinate
      Type: string

      GPS coordinates of a location; required if location_name or location_code is not specified

    • location_name
      Type: string

      Full name of search engine location; required if location_code or location_coordinate is not specified

Responses
  • 200
    Type: object

    Successful response

    • cost
      Type: number

      Total tasks cost, USD

    • status_code
      Type: integer

      General status code

    • status_message
      Type: string

      General informational message

    • tasks
      Type: array string[]

      Array of tasks

    • tasks_count
      Type: integer

      The number of tasks in the tasks array

    • tasks_error
      Type: integer

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

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

      Array of live SERP results

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

      Search URL with refinement parameters

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

      Types of search results found in SERP

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

      Elements of search results found in SERP

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

      Number of results returned in the items array

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

      Keyword received in the POST array

    • tasks[].result[].language_code
      Type: string

      Language code in the POST array

    • tasks[].result[].location_code
      Type: integer

      Location code in the POST array

    • tasks[].result[].se_domain
      Type: string

      Search engine domain in the POST array

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

      Search engine type in the POST array

    • time
      Type: string

      Execution time, seconds

    • version
      Type: 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 post/v1/beta/dataforseo/serp/google/ai_mode/live/advanced
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/ai_mode/live/advanced \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keyword": "",
    "location_code": 1,
    "location_name": "",
    "location_coordinate": "",
    "language_name": "",
    "language_code": "",
    "device": "",
    "calculate_rectangles": true,
    "browser_screen_width": 1,
    "browser_screen_height": 1,
    "browser_screen_resolution_ratio": 1
  }
]'

{
  "version": "string",
  "status_code": 1,
  "status_message": "string",
  "time": "string",
  "cost": 1,
  "tasks_count": 1,
  "tasks_error": 1,
  "tasks": [
    "string"
  ],
  "tasks[].result": [
    "string"
  ],
  "tasks[].result[].keyword": "string",
  "tasks[].result[].type": "string",
  "tasks[].result[].se_domain": "string",
  "tasks[].result[].location_code": 1,
  "tasks[].result[].language_code": "string",
  "tasks[].result[].check_url": "string",
  "tasks[].result[].item_types": [
    "string"
  ],
  "tasks[].result[].items_count": 1,
  "tasks[].result[].items": [
    "string"
  ]
}

Successful response

Live Google AI Mode SERP