SERP Data API Documentation

/live Get SERP data

Response

Models

SERPDataQuery

				
					{
query*				string
					Serp data query

country				string
					default: us
					Country code (us, au, etc.).

language			string
					default: en
					Language code (en, es, etc.). 

display_limit		integer
					default: 100
					minimum: 10
					maximum: 100
					Display limit

format				string
					default: json
					Result format (json)

					Enum:
						[ html, json, both ]
mobile_device		string
					Mobile device type

					Enum:
                        [ android, iphone, any ]
}

SerpDataQueryResult

				
					{
status	integer($int64)
        Response http-status
message	string
errors  [string]
data    {
        rankings[RankingsData{
        description string
        title       string
        url         string
        position    string
        }]
        features{
                bottom_ads	[{...}]
                featured_snippet	[{...}]
                image_pack	[{...}]
                knowledge_card[{...}]
                knowledge_panel[{...}]
                local_pack[{...}]
                news_box[{...}]
                related_questions[{...}]
                related_searches[{...}]
                reviews[{...}]
                shopping_results[{...}]
                site_links[{...}]
                spelling[{...}]
                top_ads[{...}]
                twitter[{...}]
                videos[{...}]
                jobs_pack	[[{...}]]
                }
        }
}

RankingsData

				
					{
description	    string
title	        string
url	            string
position	    integer
}