DataForSEO

Docs DataForSEO V3

- [Introduction](https://docs.dataforseo.com/v3.md) — Welcome to DataForSEO API!
- [Authentication](https://docs.dataforseo.com/v3/auth.md) — [Create an account](https://app.dataforseo.com/register) with DataForSEO and then use the credentials from your account [dashboard](https://app.dataforseo.com/api-access) to access DataForSEO APIs. Note that the API password is generated automatically by DataForSEO and is different from your account password.


## SERP API

- [SERP API: Overview](https://docs.dataforseo.com/v3/serp/overview.md) — SERP API encompasses a broad range of endpoints. You can get the full list [here](https://docs.dataforseo.com/v3/serp/endpoints.md).
- [SERP API ID List](https://docs.dataforseo.com/v3/serp/id_list.md) — This endpoint is designed to provide you with the list of IDs and metadata of the completed SERP tasks during the specified period. You will get all task IDs that were made including successful, uncompleted, and tasks that responded as errors.
- [SERP API Errors](https://docs.dataforseo.com/v3/serp/errors.md) — By calling this endpoint you will receive information about the SERP API tasks that returned an error within the past 7 days.
- [SERP API Page Screenshot](https://docs.dataforseo.com/v3/serp/screenshot.md) — Using the Live Page Screenshot endpoint, you can capture a screenshot of any SERP page.
- [SERP API AI Summary](https://docs.dataforseo.com/v3/serp/ai_summary.md) — 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.


### Google

- [Google SERP API: Overview](https://docs.dataforseo.com/v3/serp/google/overview.md) — Google SERP API provides search results based on the selected search engine type. The following is the list of available search engine types:
- [List of Google Locations for SERP](https://docs.dataforseo.com/v3/serp/google/locations.md) — Your account will not be charged for using this API
- [List of Google Languages for SERP](https://docs.dataforseo.com/v3/serp/google/languages.md) — Your account will not be charged for using this API


#### Organic

- [Google Organic SERP: Overview](https://docs.dataforseo.com/v3/serp/google/organic/overview.md) — The returned results are specific to the indicated keyword, search engine, and location parameters. We emulate set location and search engine with the highest accuracy so that the results you receive will match the actual search results for the specified parameters at the time of task setting. You can always check the returned results accessing the `check_url` in the Incognito mode to make sure the received data is entirely relevant. Note that user preferences, search history, and other personalized search factors are ignored by our system and thus would not be reflected in the returned SERP results.
- [Setting Google Organic SERP Tasks](https://docs.dataforseo.com/v3/serp/google/organic/task_post.md) — SERP API provides top 100 search engine results. These results are specific to the selected location (see [the List of Locations](https://docs.dataforseo.com/v3/serp/google/locations.md)) and language (see [the List of Languages](https://docs.dataforseo.com/v3/serp/google/languages.md)) settings.
- [Get Organic SERP Completed Tasks](https://docs.dataforseo.com/v3/serp/google/organic/tasks_ready.md) — 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.
- [Get Organic SERP Completed Tasks With Re-parsed Markup](https://docs.dataforseo.com/v3/serp/google/organic/tasks_fixed.md) — 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.


##### Task GET

- [Get Google Organic SERP Results by id](https://docs.dataforseo.com/v3/serp/google/organic/task_get/regular.md) — Your account will be charged only for posting a task. You can get the results of the task within the next 30 days for free.
- [Get Google Organic SERP Advanced Results by id](https://docs.dataforseo.com/v3/serp/google/organic/task_get/advanced.md) — Your account will be charged only for posting a task. You can get the results of the task within the next 30 days for free.
- [Get Google Organic HTML Results by id](https://docs.dataforseo.com/v3/serp/google/organic/task_get/html.md) — Your account will be charged only for posting a task. You can get the results of the task within the next 7 days for free.


##### Live

- [Live Google Organic SERP Regular](https://docs.dataforseo.com/v3/serp/google/organic/live/regular.md) — Live SERP provides real-time data on top 100 search engine results for the specified keyword, search engine, and location.
- [Live Google Organic SERP Advanced](https://docs.dataforseo.com/v3/serp/google/organic/live/advanced.md) — Live SERP provides real-time data on top 100 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.
- [Live Google Organic SERP HTML](https://docs.dataforseo.com/v3/serp/google/organic/live/html.md) — Live SERP HTML provides a raw HTML page of 100 search engine results for the specified keyword, search engine, and location.


#### AI Mode

- [Google AI Mode SERP: Overview](https://docs.dataforseo.com/v3/serp/google/ai_mode/overview.md) — Example of Google AI Mode search engine results:
- [List of Google AI Mode Languages for SERP](https://docs.dataforseo.com/v3/serp/google/ai_mode/languages.md) — Your account will not be charged for using this API
- [Setting Google AI Mode SERP Tasks](https://docs.dataforseo.com/v3/serp/google/ai_mode/task_post.md) — Google AI Mode SERP API provides search results from the AI Mode feature of Google Search. The results are specific to the specified location (see [the List of Locations](https://docs.dataforseo.com/v3/serp/google/locations.md)) and language (see [the List of Languages](https://docs.dataforseo.com/v3/serp/google/ai_mode/languages.md)) parameters.
- [Get Ai Mode SERP Completed Tasks](https://docs.dataforseo.com/v3/serp/google/ai_mode/tasks_ready.md) — 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.
- [Get Ai Mode SERP Completed Tasks With Re-parsed Markup](https://docs.dataforseo.com/v3/serp/google/ai_mode/tasks_fixed.md) — 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.


##### Task GET

- [Get Google AI Mode SERP Advanced Results by id](https://docs.dataforseo.com/v3/serp/google/ai_mode/task_get/advanced.md) — Your account will be charged only for posting a task. You can get the results of the task within the next 30 days for free.
- [Get Google Ai Mode HTML Results by id](https://docs.dataforseo.com/v3/serp/google/ai_mode/task_get/html.md) — Your account will be charged only for posting a task. You can get the results of the task within the next 7 days for free.


##### Live

- [Live Google AI Mode SERP](https://docs.dataforseo.com/v3/serp/google/ai_mode/live/advanced.md) — Google AI Mode SERP API provides search results from the AI Mode feature of Google Search. The results are specific to the specified location (see [the List of Locations](https://docs.dataforseo.com/v3/serp/google/locations.md)) and language (see [the List of Languages](https://docs.dataforseo.com/v3/serp/google/languages.md)) parameters.
- [Live Google Ai Mode SERP HTML](https://docs.dataforseo.com/v3/serp/google/ai_mode/live/html.md) — Live SERP HTML provides a raw HTML page of 100 search engine results for the specified keyword, search engine, and location.


#### Maps

- [Google Maps SERP: Overview](https://docs.dataforseo.com/v3/serp/google/maps/overview.md) — The returned results are specific to the indicated keyword, search engine, and location parameters. Note that the results this endpoint provides are based on the “search this area” parameter, as it’s the only way to perform the search within a custom location in Google Maps. Please, make sure to select this parameter when checking the results to get accurate SERP positions.
- [Setting Google Maps SERP Tasks](https://docs.dataforseo.com/v3/serp/google/maps/task_post.md) — SERP API provides top 100 search engine results. These results are specific to the selected location (see [the List of Locations](https://docs.dataforseo.com/v3/serp/google/locations.md)) and language (see [the List of Languages](https://docs.dataforseo.com/v3/serp/google/languages.md)) settings.
- [Get Maps SERP Completed Tasks](https://docs.dataforseo.com/v3/serp/google/maps/tasks_ready.md) — 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.
- [Get Maps SERP Completed Tasks With Re-parsed Markup](https://docs.dataforseo.com/v3/serp/google/maps/tasks_fixed.md) — 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.


##### Task GET

- [Get Google Maps SERP Advanced Results by id](https://docs.dataforseo.com/v3/serp/google/maps/task_get/advanced.md) — Your account will be charged only for posting a task. You can get the results of the task within the next 30 days for free.


##### Live

- [Live Google Maps SERP](https://docs.dataforseo.com/v3/serp/google/maps/live/advanced.md) — Live Google Maps SERP provides real-time data on top 100 search engine results for the specified keyword, search engine, and location.


#### Local Finder

- [Google Local Finder SERP: Overview](https://docs.dataforseo.com/v3/serp/google/local_finder/overview.md) — The returned results are specific to the indicated keyword, search engine, and location parameters.
- [Setting Google Local Finder SERP Tasks](https://docs.dataforseo.com/v3/serp/google/local_finder/task_post.md) — Google Local Finder SERP API provides top search engine results specific to the selected location (see [the List of Locations](https://docs.dataforseo.com/v3/serp/google/locations.md)) and language (see [the List of Languages](https://docs.dataforseo.com/v3/serp/google/languages.md)) settings.
- [Get Local Finder SERP Completed Tasks](https://docs.dataforseo.com/v3/serp/google/local_finder/tasks_ready.md) — 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.
- [Get Local Finder SERP Completed Tasks With Re-parsed Markup](https://docs.dataforseo.com/v3/serp/google/local_finder/tasks_fixed.md) — 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.


##### Task GET

- [Get Google Local Finder SERP Advanced Results by id](https://docs.dataforseo.com/v3/serp/google/local_finder/task_get/advanced.md) — Your account will be charged only for posting a task. You can get the results of the task within the next 30 days for free.
- [Get Google Local Finder HTML Results by id](https://docs.dataforseo.com/v3/serp/google/local_finder/task_get/html.md) — Your account will be charged only for posting a task. You can get the results of the task within the next 7 days for free.


##### Live

- [Live Google Local Finder SERP](https://docs.dataforseo.com/v3/serp/google/local_finder/live/advanced.md) — Live Google Local\_finder SERP provides real-time search engine results for the specified keyword and location. By default, you can get up to 20 results for desktop and up to 10 results for mobile.