The Serp API from DataForSEO — 181 operation(s) for serp.
openapi: 3.0.1
info:
title: DataForSEO AiOptimization Serp API
description: DataForSEO API is the starting point on your journey towards building powerful SEO software. With DataForSEO you can get all the data you need to build an efficient application while also saving your time and budget. DataForSEO API is using the REST technology for interchanging data between your application and our service. The data exchange is made through the widely used HTTP protocol, which allows applying our API to almost all programming languages.
version: 1.0.0
servers:
- url: https://api.dataforseo.com
- url: https://sandbox.dataforseo.com
tags:
- name: Serp
paths:
/v3/serp/id_list:
post:
tags:
- Serp
description: 'This endpoint is designed to provide you with a list of IDs and metadata for all SERP tasks created within the specified time period, including both successful and uncompleted tasks.
for more info please visit ''https://docs.dataforseo.com/v3/serp/id_list/?bash'''
operationId: IdList
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/SerpIdListRequestInfo'
nullable: true
example:
- datetime_from: '2026-04-12 04:39:39 +00:00'
datetime_to: '2026-04-14 04:39:39 +00:00'
limit: 100
offset: 0
sort: desc
include_metadata: true
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/SerpIdListResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/serp/errors:
post:
tags:
- Serp
description: 'By calling this endpoint you will receive information about the SERP API tasks that returned an error within the past 7 days.
for more info please visit ''https://docs.dataforseo.com/v3/serp/errors/?bash'''
operationId: Errors
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/SerpErrorsRequestInfo'
nullable: true
example:
- limit: 10
offset: 0
filtered_function: pingback_url
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/SerpErrorsResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/serp/screenshot:
post:
tags:
- Serp
description: 'Using the Live Page Screenshot endpoint, you can capture a screenshot of any SERP page.
for more info please visit ''https://docs.dataforseo.com/v3/serp/screenshot/?bash'''
operationId: Screenshot
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/SerpScreenshotRequestInfo'
nullable: true
example:
- task_id: 06211235-0696-0139-1000-36727fbd3c90
browser_screen_scale_factor: 0.5
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/SerpScreenshotResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/serp/ai_summary:
post:
tags:
- Serp
description: 'The purpose of the Live SERP API AI Summary endpoint is to provide a summary of the content found on any SERP and generate a response based on the user’s specified prompt.
To obtain results, you have to specify task_id, which you can find in the response to the POST request.
Learn more in our Help Center.
for more info please visit ''https://docs.dataforseo.com/v3/serp/ai_summary/?bash'''
operationId: AiSummary
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/SerpAiSummaryRequestInfo'
nullable: true
example:
- task_id: 07031739-1535-0139-0000-9d1e639a5b7d
prompt: explain what DataForSEO is
include_links: true
fetch_content: true
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/SerpAiSummaryResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/serp/google/locations:
get:
tags:
- Serp
description: 'You will receive the list of locations by this API call. You can filter the list of locations by country when setting a task.
for more info please visit ''https://docs.dataforseo.com/v3/serp/google/locations/?bash'''
operationId: GoogleLocations
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/SerpGoogleLocationsResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/serp/google/locations/{country}:
get:
tags:
- Serp
description: 'You will receive the list of locations by this API call. You can filter the list of locations by country when setting a task.
for more info please visit ''https://docs.dataforseo.com/v3/serp/google/locations/?bash'''
operationId: GoogleLocationsCountry
parameters:
- name: country
in: path
description: 'country ISO code
optional field
specify the ISO code if you want to filter the list of locations by country
example:
us'
required: true
schema:
type: string
example: us
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/SerpGoogleLocationsCountryResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/serp/google/languages:
get:
tags:
- Serp
description: 'You will receive the list of languages by calling this API.
for more info please visit ''https://docs.dataforseo.com/v3/serp/google/languages/?bash'''
operationId: GoogleLanguages
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/SerpGoogleLanguagesResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/serp/google/organic/task_post:
post:
tags:
- Serp
description: 'SERP API provides top 10 search engine results by default. These results are specific to the selected location (see the List of Locations) and language (see the List of Languages) settings.
for more info please visit ''https://docs.dataforseo.com/v3/serp/google/organic/task_post/?bash'''
operationId: GoogleOrganicTaskPost
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/SerpGoogleOrganicTaskPostRequestInfo'
nullable: true
example:
- language_code: en
location_code: 2840
keyword: albert einstein
- language_name: English
location_name: United States
keyword: albert einstein
priority: 2
tag: some_string_123
pingback_url: https://your-server.com/pingscript?id=$id&tag=$tag
- url: https://www.google.co.uk/search?q=albert%20einstein&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS
postback_data: html
postback_url: https://your-server.com/postbackscript
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/SerpGoogleOrganicTaskPostResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/serp/google/organic/tasks_ready:
get:
tags:
- Serp
description: 'The ‘Tasks Ready’ endpoint is designed to provide you with the list of completed tasks, which haven’t been collected yet. If you use the Standard method without specifying the postback_url, you can receive the list of id for all completed tasks using this endpoint. Then, you can collect the results using the ‘Task GET’ endpoint.
Learn more about task completion and obtaining a list of completed tasks in this help center article.
for more info please visit ''https://docs.dataforseo.com/v3/serp/google/organic/tasks_ready/?bash'''
operationId: GoogleOrganicTasksReady
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/SerpGoogleOrganicTasksReadyResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/serp/tasks_ready:
get:
tags:
- Serp
description: 'The ‘Tasks Ready’ endpoint is designed to provide you with the list of completed tasks, which haven’t been collected yet. If you use the Standard method without specifying the postback_url, you can receive the list of id for all completed tasks using this endpoint. Then, you can collect the results using the ‘Task GET’ endpoint.
Learn more about task completion and obtaining a list of completed tasks in this help center article.
for more info please visit ''https://docs.dataforseo.com/v3/serp/google/organic/tasks_ready/?bash'''
operationId: TasksReady
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/SerpTasksReadyResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/serp/google/organic/tasks_fixed:
get:
tags:
- Serp
description: 'The ‘Tasks Fixed’ endpoint is designed to provide you with the list of re-parsed tasks, which haven’t been collected yet. If you use the Standard method without specifying the postback_url, you can receive the list of id for all completed re-parsed tasks using this endpoint. Then, you can re-collect the fixed results using the ‘Task GET’ endpoint.
for more info please visit ''https://docs.dataforseo.com/v3/serp/google/organic/tasks_fixed/?bash'''
operationId: GoogleOrganicTasksFixed
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/SerpGoogleOrganicTasksFixedResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/serp/google/organic/task_get/regular/{id}:
get:
tags:
- Serp
description: 'Description of the fields for sending a request:
for more info please visit ''https://docs.dataforseo.com/v3/serp/google/organic/task_get/regular/?bash'''
operationId: GoogleOrganicTaskGetRegular
parameters:
- name: id
in: path
description: 'task identifier
unique task identifier in our system in the UUID format
you will be able to use it within 30 days to request the results of the task at any time'
required: true
schema:
type: string
example: 00000000-0000-0000-0000-000000000000
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/SerpGoogleOrganicTaskGetRegularResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/serp/google/organic/task_get/advanced/{id}:
get:
tags:
- Serp
description: 'Description of the fields for sending a request:
for more info please visit ''https://docs.dataforseo.com/v3/serp/google/organic/task_get/advanced/?bash'''
operationId: GoogleOrganicTaskGetAdvanced
parameters:
- name: id
in: path
description: 'task identifier
unique task identifier in our system in the UUID format
you will be able to use it within 30 days to request the results of the task at any time'
required: true
schema:
type: string
example: 00000000-0000-0000-0000-000000000000
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/SerpGoogleOrganicTaskGetAdvancedResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/serp/google/organic/task_get/html/{id}:
get:
tags:
- Serp
description: 'Description of the fields for sending a request:
for more info please visit ''https://docs.dataforseo.com/v3/serp/google/organic/task_get/html/?bash'''
operationId: GoogleOrganicTaskGetHtml
parameters:
- name: id
in: path
description: 'task identifier
unique task identifier in our system in the UUID format
you will be able to use it within 7 days to request the results of the task at any time'
required: true
schema:
type: string
example: 00000000-0000-0000-0000-000000000000
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/SerpGoogleOrganicTaskGetHtmlResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/serp/google/organic/live/regular:
post:
tags:
- Serp
description: 'Live SERP provides real-time data on search engine results for the specified keyword, search engine, and location.
for more info please visit ''https://docs.dataforseo.com/v3/serp/google/organic/live/regular/?bash'''
operationId: GoogleOrganicLiveRegular
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/SerpGoogleOrganicLiveRegularRequestInfo'
nullable: true
example:
- language_code: en
location_code: 2840
keyword: albert einstein
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/SerpGoogleOrganicLiveRegularResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/serp/google/organic/live/advanced:
post:
tags:
- Serp
description: 'Live SERP provides real-time data on top search engine results for the specified keyword, search engine, and location. This endpoint will supply a complete overview of featured snippets and other extra elements of SERPs.
for more info please visit ''https://docs.dataforseo.com/v3/serp/google/organic/live/advanced/?bash'''
operationId: GoogleOrganicLiveAdvanced
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/SerpGoogleOrganicLiveAdvancedRequestInfo'
nullable: true
example:
- language_code: en
location_code: 2840
keyword: albert einstein
calculate_rectangles: true
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/SerpGoogleOrganicLiveAdvancedResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/serp/google/organic/live/html:
post:
tags:
- Serp
description: 'Live SERP HTML provides a raw HTML page of search engine results for the specified keyword, search engine, and location.
for more info please visit ''https://docs.dataforseo.com/v3/serp/google/organic/live/html/?bash'''
operationId: GoogleOrganicLiveHtml
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/SerpGoogleOrganicLiveHtmlRequestInfo'
nullable: true
example:
- language_code: en
location_code: 2840
keyword: albert einstein
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/SerpGoogleOrganicLiveHtmlResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/serp/google/ai_mode/languages:
get:
tags:
- Serp
description: 'You will receive the list of languages by calling this API.
As a response of the API server, you will receive JSON-encoded data containing a tasks array with the information specific to the set tasks.
for more info please visit ''https://docs.dataforseo.com/v3/serp/google/ai_mode/languages/?bash'''
operationId: GoogleAiModeLanguages
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/SerpGoogleAiModeLanguagesResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/serp/google/ai_mode/task_post:
post:
tags:
- Serp
description: 'Google AI Mode SERP API provides search results from the AI Mode feature of Google Search.
for more info please visit ''https://docs.dataforseo.com/v3/serp/google/ai_mode/task_post/?bash'''
operationId: GoogleAiModeTaskPost
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/SerpGoogleAiModeTaskPostRequestInfo'
nullable: true
example:
- language_code: en
location_code: 2840
keyword: what is google ai mode
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/SerpGoogleAiModeTaskPostResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/serp/google/ai_mode/tasks_ready:
get:
tags:
- Serp
description: 'The ‘Tasks Ready’ endpoint is designed to provide you with the list of completed tasks, which haven’t been collected yet. If you use the Standard method without specifying the postback_url, you can receive the list of id for all completed tasks using this endpoint. Then, you can collect the results using the ‘Task GET’ endpoint.
Learn more about task completion and obtaining a list of completed tasks in this help center article.
for more info please visit ''https://docs.dataforseo.com/v3/serp/google/ai_mode/tasks_ready/?bash'''
operationId: GoogleAiModeTasksReady
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/SerpGoogleAiModeTasksReadyResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/serp/google/ai_mode/tasks_fixed:
get:
tags:
- Serp
description: 'The ‘Tasks Fixed’ endpoint is designed to provide you with the list of re-parsed tasks, which haven’t been collected yet. If you use the Standard method without specifying the postback_url, you can receive the list of id for all completed re-parsed tasks using this endpoint. Then, you can re-collect the fixed results using the ‘Task GET’ endpoint.
for more info please visit ''https://docs.dataforseo.com/v3/serp/google/ai_mode/tasks_fixed/?bash'''
operationId: GoogleAiModeTasksFixed
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/SerpGoogleAiModeTasksFixedResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/serp/google/ai_mode/task_get/advanced/{id}:
get:
tags:
- Serp
description: 'Description of the fields for sending a request:
for more info please visit ''https://docs.dataforseo.com/v3/serp/google/ai_mode/task_get/advanced/?bash'''
operationId: GoogleAiModeTaskGetAdvanced
parameters:
- name: id
in: path
description: 'task identifier
a universally unique identifier (UUID)
unique task identifier in our system
you will be able to use it within 30 days to request the results of the task at any time'
required: true
schema:
type: string
example: 00000000-0000-0000-0000-000000000000
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/SerpGoogleAiModeTaskGetAdvancedResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/serp/google/ai_mode/task_get/html/{id}:
get:
tags:
- Serp
description: 'Description of the fields for sending a request:
for more info please visit ''https://docs.dataforseo.com/v3/serp/google/ai_mode/task_get/html/?bash'''
operationId: GoogleAiModeTaskGetHtml
parameters:
- name: id
in: path
description: 'task identifier
unique task identifier in our system in the UUID format
you will be able to use it within 7 days to request the results of the task at any time'
required: true
schema:
type: string
example: 00000000-0000-0000-0000-000000000000
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/SerpGoogleAiModeTaskGetHtmlResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/serp/google/ai_mode/live/advanced:
post:
tags:
- Serp
description: 'Google AI Mode SERP API provides search results from the AI Mode feature of Google Search.
for more info please visit ''https://docs.dataforseo.com/v3/serp/google/ai_mode/live/advanced/?bash'''
operationId: GoogleAiModeLiveAdvanced
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/SerpGoogleAiModeLiveAdvancedRequestInfo'
nullable: true
example:
- language_code: en
location_code: 2840
keyword: what is google ai mode
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/SerpGoogleAiModeLiveAdvancedResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/serp/google/ai_mode/live/html:
post:
tags:
- Serp
description: 'Live SERP HTML provides a raw HTML page of 100 search engine results for the specified keyword, search engine, and location.
for more info please visit ''https://docs.dataforseo.com/v3/serp/google/ai_mode/live/html/?bash'''
operationId: GoogleAiModeLiveHtml
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/SerpGoogleAiModeLiveHtmlRequestInfo'
nullable: true
example:
- language_code: en
location_code: 2840
keyword: albert einstein
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/SerpGoogleAiModeLiveHtmlResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/serp/google/maps/task_post:
post:
tags:
- Serp
description: 'SERP API provides top 100 search engine results. These results are specific to the selected location (see the List of Locations) and language (see the List of Languages) settings.
for more info please visit ''https://docs.dataforseo.com/v3/serp/google/maps/task_post/?bash'''
operationId: GoogleMapsTaskPost
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/SerpGoogleMapsTaskPostRequestInfo'
nullable: true
example:
- language_code: en
location_code: 2840
keyword: albert einstein
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/SerpGoogleMapsTaskPostResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/serp/google/maps/tasks_ready:
get:
tags:
- Serp
description: 'The ‘Tasks Ready’ endpoint is designed to provide you with the list of completed tasks, which haven’t been collected yet. If you use the Standard method without specifying the postback_url, you can receive the list of id for all completed tasks using this endpoint. Then, you can collect the results using the ‘Task GET’ endpoint.
Learn more about task completion and obtaining a list of completed tasks in this help center article.
for more info please visit ''https://docs.dataforseo.com/v3/serp/google/maps/tasks_ready/?bash'''
operationId: GoogleMapsTasksReady
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/SerpGoogleMapsTasksReadyResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/serp/google/maps/tasks_fixed:
get:
tags:
- Serp
description: 'The ‘Tasks Fixed’ endpoint is designed to provide you with the list of re-parsed tasks, which haven’t been collected yet. If you use the Standard method without specifying the postback_url, you can receive the list of id for all completed re-parsed tasks using this endpoint. Then, you can re-collect the fixed results using the ‘Task GET’ endpoint.
for more info please visit ''https://docs.dataforseo.com/v3/serp/google/maps/tasks_fixed/?bash'''
operationId: GoogleMapsTasksFixed
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/SerpGoogleMapsTasksFixedResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/serp/google/maps/task_get/advanced/{id}:
get:
tags:
- Serp
description: 'Description of the fields for sending a request:
for more info please visit ''https://docs.dataforseo.com/v3/serp/google/maps/task_get/advanced/?bash'''
operationId: GoogleMapsTaskGetAdvanced
parameters:
- name: id
in: path
description: 'task identifier
a universally unique identifier (UUID)
unique task identifier in our system
you will be able to use it within 30 days to request the results of the task at any time'
required: true
schema:
type: string
example: 00000000-0000-0000-0000-000000000000
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/SerpGoogleMapsTaskGetAdvancedResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/serp/google/maps/live/advanced:
post:
tags:
- Serp
description: 'Live Google Maps SERP provides real-time data on top 100 search engine results for the specified keyword, search engine, and location.
for more info please visit ''https://docs.dataforseo.com/v3/serp/google/maps/live/advanced/?bash'''
operationId: GoogleMapsLiveAdvanced
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/SerpGoogleMapsLiveAdvancedRequestInfo'
nullable: true
example:
- language_code: en
location_code: 2840
keyword: albert einstein
responses:
'200':
description: Successful operation
content:
applicatio
# --- truncated at 32 KB (1106 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/dataforseo/refs/heads/main/openapi/dataforseo-serp-api-openapi.yml