{"input_schema":{"type":"object","properties":{"target":{"type":"string","description":"Domain name or page url. the domain name of the target website, subdomain or URL of the target webpage; the domain name must be specified without https:// or www. ; the subdomain must be specified without https:// ; the webpage URL must be specified with https:// or www.","examples":["example.com"]},"location_code":{"type":"integer","description":"Location code. Optional."},"language_code":{"type":"string","description":"Language code. Optional."},"location_name":{"type":"string","description":"Which market to report on; omit for every market on record.","examples":["United States"]},"language_name":{"type":"string","description":"Which language to report on; omit for every language on record.","examples":["English"]},"limit":{"type":"integer","description":"How many rows to return.","default":100,"examples":[100],"maximum":1000},"order_by":{"type":"array","description":"Sort rules for the returned rows.","examples":[["keyword_data.keyword_info.search_volume,desc"]]},"filters":{"type":"array","description":"Up to eight conditions the returned rows must meet."}},"required":["target"],"additionalProperties":true,"examples":[{"target":"example.com"}]},"output_schema":{"type":"object","description":"Position-band counts and traffic estimates for the target, plus one row per ranking keyword with its metrics and ranking result.","additionalProperties":true},"addons_schema":{"type":"object","additionalProperties":false},"capability_id":"dataforseo.labs","session_compatible":true,"pricing_available":true,"id":"dataforseo/labs_google_ranked_keywords_live","object":"endpoint","provider":"dataforseo","endpoint":"labs_google_ranked_keywords_live","name":"Ranked keywords","summary":"List the keywords a domain already ranks for, with position and traffic metrics.","description":"Takes a website, subdomain, or single page and returns the queries it currently holds rankings for. Every keyword comes with its search metrics — monthly volume, competition, cost per click, bid ranges — alongside the result that earned the position, including the exact position, ranking URL, and result type. Aggregate metrics summarise the whole profile: how many results fall into each position band, an estimated monthly organic traffic figure, and what that traffic would cost to buy through ads instead.","unit":"call","price_per_unit":null,"list_price_per_unit":"0.024","reports_cost":true,"input_fields":[{"name":"target","type":"string","required":true,"description":"Domain name or page url. the domain name of the target website, subdomain or URL of the target webpage; the domain name must be specified without https:// or www. ; the subdomain must be specified without https:// ; the webpage URL must be specified with https:// or www.","example":"example.com"},{"name":"location_code","type":"integer","required":false,"description":"Location code. Optional."},{"name":"language_code","type":"string","required":false,"description":"Language code. Optional."},{"name":"location_name","type":"string","required":false,"description":"Which market to report on; omit for every market on record.","example":"United States"},{"name":"language_name","type":"string","required":false,"description":"Which language to report on; omit for every language on record.","example":"English"},{"name":"limit","type":"integer","required":false,"description":"How many rows to return.","example":100,"default":100,"max":1000},{"name":"order_by","type":"array","required":false,"description":"Sort rules for the returned rows.","example":["keyword_data.keyword_info.search_volume,desc"]},{"name":"filters","type":"array","required":false,"description":"Up to eight conditions the returned rows must meet."}],"example_request":{"provider":"dataforseo","endpoint":"labs_google_ranked_keywords_live","input":{"target":"example.com"}},"output":"Position-band counts and traffic estimates for the target, plus one row per ranking keyword with its metrics and ranking result.","limits":{"request_bytes":1000000,"timeout_ms":180000,"input_characters":null,"audio_bytes":null}}