serp_organic_live_advanced
Retrieve real-time organic search results for specific keywords across search engines, locations, and devices to analyze SERP data and enhance SEO strategies.
Instructions
Get organic search results for a keyword in specified search engine
Input Schema
Name | Required | Description | Default |
---|---|---|---|
depth | No | parsing depth optional field number of results in SERP | |
device | No | device type optional field can take the values:desktop, mobile default value: desktop | desktop |
keyword | Yes | Search keyword | |
language_code | Yes | search engine language code (e.g., 'en') | |
location_name | No | full name of the location required field Location format - hierarchical, comma-separated (from most specific to least) Can be one of: 1. Country only: "United States" 2. Region,Country: "California,United States" 3. City,Region,Country: "San Francisco,California,United States" | United States |
max_crawl_pages | No | page crawl limit optional field number of search results pages to crawl max value: 100 Note: the max_crawl_pages and depth parameters complement each other | |
people_also_ask_click_depth | No | clicks on the corresponding element specify the click depth on the people_also_ask element to get additional people_also_ask_element items; | |
search_engine | No | search engine name, one of: google, yahoo, bing. |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"depth": {
"default": 10,
"description": "parsing depth\noptional field\nnumber of results in SERP",
"maximum": 700,
"minimum": 10,
"type": "number"
},
"device": {
"default": "desktop",
"description": "device type\noptional field\ncan take the values:desktop, mobile\ndefault value: desktop",
"type": "string"
},
"keyword": {
"description": "Search keyword",
"type": "string"
},
"language_code": {
"description": "search engine language code (e.g., 'en')",
"type": "string"
},
"location_name": {
"default": "United States",
"description": "full name of the location\nrequired field\nLocation format - hierarchical, comma-separated (from most specific to least)\n Can be one of:\n 1. Country only: \"United States\"\n 2. Region,Country: \"California,United States\"\n 3. City,Region,Country: \"San Francisco,California,United States\"",
"type": "string"
},
"max_crawl_pages": {
"default": 1,
"description": "page crawl limit\noptional field\nnumber of search results pages to crawl\nmax value: 100\nNote: the max_crawl_pages and depth parameters complement each other",
"maximum": 7,
"minimum": 1,
"type": "number"
},
"people_also_ask_click_depth": {
"description": "clicks on the corresponding element\n specify the click depth on the people_also_ask element to get additional people_also_ask_element items;",
"maximum": 4,
"minimum": 1,
"type": "number"
},
"search_engine": {
"default": "google",
"description": "search engine name, one of: google, yahoo, bing.",
"type": "string"
}
},
"required": [
"language_code",
"keyword"
],
"type": "object"
}