Google Organic SERP Live Advanced

POST

/serp/google/organic/live/advanced

Live SERP provides real-time data on top 100 search engine results for the specified keyword, search engine, and location in response to a single request. The Advanced endpoint will supply a complete overview of featured snippets and other extra elements of SERPs.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.dataforseo.com/v3/serp/google/organic/live/advanced' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic Og==' \
--data-raw '[
    {
        "keyword": "albert einstein",
        "location_name": "united states",
        "language_name": "english"
    }
]'

Response Example

{
    "version": "0.1.20241227",
    "status_code": 20000,
    "status_message": "Ok.",
    "time": "4.9189 sec.",
    "cost": 0.002,
    "tasks_count": 1,
    "tasks_error": 0,
    "tasks": [
        {
            "id": "03251229-8029-0139-0000-3b03dc7c8df7",
            "status_code": 20000,
            "status_message": "Ok.",
            "time": "4.8204 sec.",
            "cost": 0.002,
            "result_count": 1,
            "path": [
                "v3",
                "serp",
                "google",
                "organic",
                "live",
                "advanced"
            ],
            "data": {
                "api": "serp",
                "function": "live",
                "se": "google",
                "se_type": "organic",
                "keyword": "albert einstein",
                "location_name": "united states",
                "language_name": "english",
                "device": "desktop",
                "os": "windows"
            },
            "result": [
                {
                    "keyword": "albert einstein",
                    "type": "organic",
                    "se_domain": "google.com",
                    "location_code": 2840,
                    "language_code": "en",
                    "check_url": "https://www.google.com/search?q=albert%20einstein&num=100&hl=en&gl=US&gws_rd=cr&ie=UTF-8&oe=UTF-8&glp=1&uule=w+CAIQIFISCQs2MuSEtepUEUK33kOSuTsc",
                    "datetime": "2025-03-25 10:29:34 +00:00",
                    "spell": null,
                    "refinement_chips": null,
                    "item_types": [
                        "organic",
                        "people_also_ask",
                        "perspectives",
                        "video",
                        "related_searches",
                        "knowledge_graph"
                    ],
                    "se_results_count": 165000000,
                    "items_count": 30,
                    "items": [
                        {
                            "type": "knowledge_graph",
                            "rank_group": 1,
                            "rank_absolute": 1,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[3]/div[1]/div[12]",
                            "title": "Albert Einstein",
                            "subtitle": "Theoretical physicist",
                            "description": null,
                            "card_id": null,
                            "url": null,
                            "image_url": null,
                            "logo_url": null,
                            "cid": null,
                            "items": [
                                {
                                    "type": "knowledge_graph_row_item",
                                    "rank_group": 0,
                                    "rank_absolute": 0,
                                    "position": "left",
                                    "xpath": "/html[1]/body[1]/div[3]/div[1]/div[12]/div[5]/div[2]/div[1]/div[1]/div[2]/div[1]/div[1]/div[1]/div[1]/div[2]",
                                    "title": "Born",
                                    "data_attrid": "kc:/people/person:born",
                                    "text": "Born : March 14, 1879, Ulm, Germany",
                                    "links": [
                                        {
                                            "type": "link_element",
                                            "title": "Ulm, Germany",
                                            "url": "https://www.google.com/search?num=100&sca_esv=7d1b82273738a5db&hl=en&gl=US&glp=1&q=Ulm&si=APYL9btMsmZl0P9CyeA1NmMZFYv4xkDb-_Q4WCJadY9pxozSRV9RJ1bpE-4_M_uphgsOINSI1A9MtY5vYrayodLFVll_ttMj55wGE95K2xeok8PQdkTK2HbnDucpb3xL_u4E4NYEFlIcYO0b_3b89Wnm2lIWs5KWyvOK0AYB6sy9rzd_1rtgIQvAGrPx0KKLG5dqKGjf5cWI&sa=X&ved=2ahUKEwiest-Rg6WMAxU0lokEHSG3Kk4QmxMoAHoECB0QAg",
                                            "domain": "www.google.com",
                                            "description": null,
                                            "xpath": "/html[1]/body[1]/div[3]/div[1]/div[12]/div[5]/div[2]/div[1]/div[1]/div[2]/div[1]/div[1]/div[1]/div[1]/div[2]/div[1]/div[1]/div[1]/span[2]/span[1]/a[1]"
                                        }
                                    ],
                                    "rectangle": null
                                },
                                {
                                    "type": "knowledge_graph_row_item",
                                    "rank_group": 0,
                                    "rank_absolute": 0,
                                    "position": "left",
                                    "xpath": "/html[1]/body[1]/div[3]/div[1]/div[12]/div[5]/div[2]/div[1]/div[1]/div[2]/div[1]/div[1]/div[1]/div[1]/div[3]",
                                    "title": "Died",

Request

Authorization

Send your HTTP requests with an

Authorization

header that contains the word Basic followed by a space and a base64-encoded string username:password

Example:

Authorization: Basic *****************

Body Params application/json

array of:

keyword

string

required

All %## will be decoded (plus character ‘+’ will be decoded to a space character). If you need to use the “%” character for your keyword, please specify it as “%25”. If you need to use the “+” character for your keyword, please specify it as “%2B”.

<= 700 characters

location_name

string

required

Full name of search engine location. You can find the supported locations in the DataForSEO documentation.

language_name

string

required

Full name of search engine language. You can find the supported languages in the DataForSEO documentation.

url

string

optional

Direct URL of the search query. You can specify a direct URL and we will sort it out to the necessary fields.

depth

integer

optional

Parsing depth. Number of results in SERP.

<= 700

Default:

100

max_crawl_pages

integer

optional

Page crawl limit. Number of search results pages to crawl.

<= 100

location_coordinate

string

optional

GPS coordinates of a location. If you use this field, you don’t need to specify location_name. location_coordinate parameter should be specified in the latitude,longitude,radius format. The maximum number of decimal digits for latitude and longitude: 7. The minimum value for “radius”: 199.9 (mm), the maximum value for “radius”: 199999 (mm). Example: 53.476225,-2.243572,200.

se_domain

string

optional

Search engine domain. We choose the relevant search engine domain automatically according to the location and language you specify
however, you can set a custom search engine domain in this field.

device

enum<string>

optional

Device type.

Allowed values:

desktopmobile

Default:

desktop

enum<string>

optional

Device operating system.

Allowed values:

windowsmacosandroidios

target

string

optional

Target domain, subdomain, or webpage to get results for. A domain or a subdomain should be specified without https:// and www.. You can also use a wildcard (*) character to specify the search pattern in SERP and narrow down the results.

group_organic_results

boolean

optional

Display related results. If set to true, the related_result element in the response will be provided as a snippet of its parent organic result. If set to false, the related_result element will be provided as a separate organic result.

Default:

true

calculate_rectangles

boolean

optional

Calcualte pixel rankings for SERP elements in advanced results.

Default:

false

browser_screen_width

integer

optional

Browser screen width. You can set a custom browser screen width to calculate pixel rankings for a particular device.

browser_screen_height

integer

optional

Browser screen height. You can set a custom browser screen height to calculate pixel rankings for a particular device.

browser_screen_resolution_ratio

integer

optional

Browser screen resolution ratio. You can set a custom browser screen resolution ratio to calculate pixel rankings for a particular device.

people_also_ask_click_depth

enum<integer>

optional

Clicks on the corresponding element. Specify the click depth on the people_also_ask element to get additional people_also_ask_element items.

Allowed values:

1234

load_async_ai_overview

boolean

optional

Load asynchronous ai overview. Set to true to obtain ai_overview items is SERPs even if they are loaded asynchronically. If set to false, you will only obtain ai_overview items from cache.

Default:

false

search_param

string

optional

Additional parameters of the search query. You can find the list of available parameters and additional details here.

remove_from_url

array[string]

optional

Remove specific parameters from URLs. Example: "remove_from_url": ["srsltid"].

<= 10 items

tag

string

optional

User-defined task identifier. You can use this parameter to identify the task and match it with the result.

Examples

Responses

🟢200Success

application/json

Body

object {0}

Modified at 2025-05-30 07:58:06

Google Organic SERP Live Regular

Google Organic SERP Live HTML