{"endpoint":{"id":"treg.google.serp.organic","provider":"treg","provider_display":"treg","name":"google.serp.organic — routed: best of 5 providers, own keys first","summary":"Google organic results for a keyword — provider-native result rows in `results`; `limit` is the depth","method":"POST","path":"/google.serp.organic","scope":"","tier":"core","kind":"routed","domain":"routed","call_template":"treg call treg.google.serp.organic --method POST --data '{\"q\":\"…\"}'","cost":{"type":"per_success","value":0.00188,"currency":"USD","per":1,"unit":"call","source":"inferred","confidence":"documented","checked":null,"note":"the children's range $0.00188–$0.015 per hit; you pay exactly the child that served, 0% markup","usd":0.00188},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":{"status":200,"means":"output.results == []"},"status":null,"status_note":null,"superseded_by":null,"verified":null,"docs_url":"","has_example":false,"input":{"bodyType":"json","body":{"q":{"type":"str","required":false,"note":"identity key (part of q)"},"country":{"type":"str","required":false,"note":"filter — default 'us'; ISO country code; mapped to each provider's location code / gl / region"},"language":{"type":"str","required":false,"note":"filter — default 'en'"},"limit":{"type":"int","required":false,"note":"filter — default 10; results to return where the provider bills by depth"}},"note":"Send everything you know about the subject — treg derives the rest (full_name ⇄ first+last), matches each provider on the variants it accepts ({q}) and sends each provider only the fields it wants. On a miss treg keeps trying providers, cheapest first, within X-Treg-Route-Max-Cost (default $1 per call; misses on per-success providers are free). Options ride as headers, never in the body: X-Treg-Route-Waterfall: 0 (stop at the first miss), X-Treg-Route-Max-Cost: , X-Treg-Route-Prefer / X-Treg-Route-Exclude: . The response is {output, raw, _treg: {served_by, tried}}; X-Treg-Served-By names the child."},"test_request":{"body":{"q":"…"}},"routed_children":["dataforseo.x.serp-google-organic-live-advanced","dataforseo.google.serp.organic","scrapecreators.x.v1-google-search","serpapi.x.google-light","serpapi.google.serp.organic"],"capability":"google.serp.organic","capability_description":"Get organic search results for a keyword","platform":"google","platform_label":"Google Keyword Data","observed":{"samples":48931,"decided":48468,"ok_rate":0.9913,"p50_ms":null,"p95_ms":null,"last_ok_days":0,"hit_rate":null,"hit_samples":0}},"provider":{"service":"treg","display_name":"treg"},"siblings":[{"id":"cloro.google.serp.organic","provider":"cloro","provider_display":"cloro","name":"Google SERP — organic, PAA, local pack, AI Overview","summary":"Returns a parsed Google SERP for a keyword from a chosen country: organic results with sitelinks, People Also Ask, related searches, local pack, knowledge graph, shopping cards, sponsored ads and, on request, the AI Overview.","method":"POST","path":"/v1/monitor/google","scope":"any_account","tier":"core","kind":"data","domain":"serp","call_template":"treg call cloro.google.serp.organic --method POST --data '{\"query\":\"what is a stock split\",\"gl\":\"US\",\"pages\":1,\"include\":{\"html\":true,\"aioverview\":true,\"paaAioverview\":true,\"googleGoto\":true}}'","cost":{"type":"per_call","value":7,"currency":"credit","per":1,"unit":"call","source":"docs","source_url":"https://cloro.dev/docs/guides/providers","checked":"2026-09-05","confidence":"documented","note":"7 = 3 base + 2 for include.aioverview / paaAioverview + the 2-credit sync surcharge, for one page. A plain call without the AI Overview flags is 5. html and googleGoto are free. Each page past the first adds 2, and `pages` is capped at 10, so 23 is the ceiling. A failed extraction is not charged.","usd":0.0056},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":null,"docs_url":"https://cloro.dev/docs/api-reference/endpoint/monitor-google","has_example":false,"input":{"body":{"query":{"type":"string","required":false,"note":"the keyword. Pass query or url, not both.","example":"best running shoes"},"url":{"type":"string","required":false,"note":"a complete google.com/search URL used as the fetch target instead of the structured fields. The URL owns query, location, uule and pages."},"gl":{"type":"string","required":false,"note":"result geography, ISO 3166-1 alpha-2. Required in structured mode; derived from the URL's gl otherwise. `country` is a deprecated alias.","example":"US"},"hl":{"type":"string","required":false,"note":"interface language","example":"en"},"location":{"type":"string","required":false,"note":"free-text location; mutually exclusive with uule"},"uule":{"type":"string","required":false,"note":"Google UULE location string; mutually exclusive with location"},"device":{"type":"string","required":false,"note":"desktop | mobile","example":"desktop"},"pages":{"type":"integer","required":false,"note":"1-10, default 1. Each page past the first adds 2 credits.","example":1},"include":{"type":"object","required":false,"note":"any of html, aioverview, paaAioverview, googleGoto. html and googleGoto are free; aioverview or paaAioverview adds 2 credits."}},"bodyType":"json"},"test_request":{"body":{"query":"what is a stock split","gl":"US","pages":1,"include":{"html":true,"aioverview":true,"paaAioverview":true,"googleGoto":true}},"bodyType":"json"},"observed":{"samples":0,"decided":0,"ok_rate":null,"p50_ms":null,"p95_ms":null,"last_ok_days":null,"hit_rate":null,"hit_samples":0}},{"id":"dataforseo.google.serp.organic","provider":"dataforseo","provider_display":"DataForSEO","name":"Google organic search results for a keyword, live","summary":"Live Google organic results for a keyword — rank, title, URL, snippet — by location","method":"POST","path":"/serp/google/organic/live/regular","scope":"any_account","tier":"core","kind":"data","domain":"serp","call_template":"treg call dataforseo.google.serp.organic --method POST --data '[{\"keyword\":\"coffee\",\"location_code\":2840,\"language_code\":\"en\",\"depth\":10}]'","cost":{"type":"per_call","value":0.002,"currency":"USD","per":1,"unit":"call","source":"rate_card_api","source_url":"https://api.dataforseo.com/v3/appendix/user_data","checked":"2026-07-28","confidence":"verified","note":"$0.002 per request; confirmed against the account's own machine-readable rate card (GET /appendix/user_data -> result[0].price), which quotes the same $0.002 for live/advanced — the advanced premium shows up via depth (billed per 10 results) and via advanced search operators, which multiply the price by 5","usd":0.002},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-07-28","docs_url":"https://docs.dataforseo.com/v3/serp/google/organic/live/regular","has_example":true,"input":{"bodyType":"json","body":{"keyword":{"type":"string","required":true,"note":"up to 700 chars; advanced search operators multiply the price by 5","example":"coffee"},"location_code":{"type":"integer","required":true,"note":"one of location_code | location_name | location_coordinate; 2840 = United States","example":2840},"location_name":{"type":"string","required":false,"note":"alternative to location_code, e.g. \"United States\""},"language_code":{"type":"string","required":true,"note":"one of language_code | language_name","example":"en"},"depth":{"type":"integer","required":false,"note":"results to return, default 10, max 200 — billed per 10 results","example":10},"device":{"type":"string","required":false,"note":"desktop (default) | mobile"},"os":{"type":"string","required":false,"note":"windows/macos for desktop, android/ios for mobile"}},"note":"POST body is an array of these task objects; one element = one billable task.\n`/live/regular` is the cheap variant used here: plain organic + a few SERP feature types.\n`/live/advanced` costs more and adds the full set of SERP features (people_also_ask,\nAI overview, images, videos, …) — switch paths if you need those elements.\n"},"test_request":{"body":[{"keyword":"coffee","location_code":2840,"language_code":"en","depth":10}]},"observed":{"samples":74745,"decided":74629,"ok_rate":1.0,"p50_ms":3100,"p95_ms":18948,"last_ok_days":0,"hit_rate":1.0,"hit_samples":65056}},{"id":"dataforseo.x.serp-google-organic-live-advanced","provider":"dataforseo","provider_display":"DataForSEO","name":"Google organic results for a keyword — full SERP features","summary":"Live SERP provides real-time data on top search engine results for the specified keyword, search engine, and location.","method":"POST","path":"/serp/google/organic/live/advanced","scope":"","tier":"extended","kind":"data","domain":"serp","call_template":"treg call dataforseo.x.serp-google-organic-live-advanced --method POST --data '[{\"language_code\":\"en\",\"location_code\":2840,\"keyword\":\"albert einstein\",\"calculate_rectangles\":true}]'","cost":{"type":"per_call","value":0.004,"currency":"USD","per":1,"unit":"call","source":"observed","confidence":"verified","checked":"2026-07-28","note":"price observed at live verification (provider-reported charge)","usd":0.004},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-07-28","docs_url":"","has_example":true,"input":{"bodyType":"json","body":{"keyword":{"type":"string","required":false,"note":"

keyword

required field

you can specify up to 700 characters in the keyword field

all %## will be decoded (plus character ‘+’ will be decoded to a space character)

if you need to use the “%” character for your keyword, pl","example":"albert einstein"},"location_code":{"type":"integer","required":false,"note":"

search engine location code

required field if you don't specify location_name or location_coordinate

if you use this field, you don't need to specify location_name or location_coordinate

you ","example":2840},"language_code":{"type":"string","required":false,"note":"

search engine language code

optional field if you specify language_name

if you use this field, you don't need to specify language_name

you can receive the list of available languages of the search engine with their language_codeparsing depth

optional field

number of results in SERP

default value: 10

max value: 200


Your account will be billed per each SERP containing up to 10 results;

Setting depth above 10 may result in additional char"},"device":{"type":"string","required":false,"note":"

device type

optional field

return results for a specific device type

can take the values:desktop, mobile

default value: desktop

"},"load_async_ai_overview":{"type":"boolean","required":false,"note":"

load asynchronous ai overview

optional field

set to true to obtain ai_overview items is SERPs even if they are loaded asynchronously;

if set to false, you will only obtain ai_overview items from cache;

default value: false"},"location_name":{"type":"string","required":false,"note":"

full name of search engine location

required field if you don't specify location_code or location_coordinate

if you use this field, you don't need to specify location_code or location_coordinate

y"},"language_name":{"type":"string","required":false,"note":"

full name of search engine language

optional field if you specify language_code

if you use this field, you don't need to specify language_code

you can receive the list of available languages of the search engine with their language_n"},"os":{"type":"string","required":false,"note":"

device operating system

optional field

if you specify desktop in the device field, choose from the following values: windows, macos

default value: windows

if you specify mobile in the deviceuser-defined task identifier

optional field

the character limit is 255

you can use this parameter to identify the task and match it with the result

you will find the specified tag value in the data object of the response

"},"stop_crawl_on_match":{"type":"array","required":false,"note":"array of targets to stop crawling optional field if specified, the response will contain SERP results up to and including the specified match_value; you can specify up to 10 target values in this array example: \"stop_crawl_on_match\":[{\"match_value\":\"dataforseo.com\",\"match_type\":\"with_subdomains\"}] l"},"match_type":{"type":"string","required":false,"note":"

target match type

required field if stop_crawl_on_match is specified

type of match for the match_value

possible values:

domain – specific domain or subdomain

with_subdomains – main domain and subdomains

target domain, subdomain, or wildcard value

required field if stop_crawl_on_match is specified

specify a target domain, subdomain, or wildcard value;

Note: domain or subdomain must be specified without a request protocol;

example: page crawl limit

optional field

number of search results pages to crawl

max value: 100

Note: you will be charged for each page crawled (10 organic results per page);

learn more about pricing on our additional parameters of the search query

optional field

get the list of available parameters and additional details here


Note: the following search engine par"},"remove_from_url":{"type":"array","required":false,"note":"

remove specific parameters from URLs

optional field

using this field, you can specify up to 10 parameters to remove from URLs in the result

example:

\"remove_from_url\": [\"srsltid\"]

Note: if the target field is specified, the specified U"},"people_also_ask_click_depth":{"type":"integer","required":false,"note":"

clicks on the corresponding element

optional field

specify the click depth on the people_also_ask element to get additional people_also_ask_element items;

Note your account will be billed $0.00015 extra for each click;

if the element is "},"group_organic_results":{"type":"boolean","required":false,"note":"

display related results

optional field

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 separa"},"calculate_rectangles":{"type":"boolean","required":false,"note":"

calcualte pixel rankings for SERP elements in advanced results

optional field

pixel ranking refers to the distance between the result snippet and top left corner of the screen;

Visit Help Center to learn more>","example":true},"browser_screen_width":{"type":"integer","required":false,"note":"

browser screen width

optional field

you can set a custom browser screen width to calculate pixel rankings for a particular device;

can be specified within the following range: 240-9999;

by default, the parameter is set to:

1920 for desktop"},"browser_screen_height":{"type":"integer","required":false,"note":"

browser screen height

optional field

you can set a custom browser screen height to calculate pixel rankings for a particular device;

can be specified within the following range: 240-9999;

by default, the parameter is set to:

1080 for desktopbrowser screen resolution ratio

optional field

you can set a custom browser screen resolution ratio to calculate pixel rankings for a particular device;

can be specified within the following range: 0.5-3;

by default, the parameter is set to:

1 for direct URL of the search query

optional field

you can specify a direct URL and we will sort it out to the necessary fields. Note that this method is the most difficult for our API to process and also requires you to specify the exact language and location in the URL. In most cases, w"},"location_coordinate":{"type":"string","required":false,"note":"

GPS coordinates of a location

optional field if you specify location_name or location_code

if you use this field, you don't need to specify location_name or location_code

location_coordinate para"},"se_domain":{"type":"string","required":false,"note":"

search engine domain

optional field

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

example:

google.co.uk, google"},"target":{"type":"string","required":false,"note":"

target domain, subdomain, or webpage to get results for

optional field

a domain or a subdomain should be specified without https:// and www.

note that the results of target-specific tasks will only include SERP elements that contain a ur"},"target_search_mode":{"type":"string","required":false,"note":"

target matching mode

optional field

to enable this parameter, stop_crawl_on_match must also be enabled

defines how the crawl should stop when multiple targets are specified in stop_crawl_on_match

possible values: all, any

SERP element types to check for targets

optional field

to enable this parameter, stop_crawl_on_match must also be enabled

specifies which SERP element types should be checked for target matches

if not specified, all first-level elements with url and SERP element types to exclude from target search

optional field

to enable this parameter, stop_crawl_on_match must also be enabled

specifies which SERP element types should be excluded when searching for target matches

possible values: organic, pai"}},"note":"the POST body is an ARRAY of task objects with these fields — one object per task"},"test_request":{"body":[{"language_code":"en","location_code":2840,"keyword":"albert einstein","calculate_rectangles":true}],"bodyType":"json"},"observed":{"samples":6776,"decided":6725,"ok_rate":1.0,"p50_ms":null,"p95_ms":null,"last_ok_days":0,"hit_rate":1.0,"hit_samples":5654}},{"id":"scrapecreators.x.v1-google-search","provider":"scrapecreators","provider_display":"ScrapeCreators","name":"Search Google by keyword — organic results","summary":"Performs a Google search and returns organic results with url, title, and description for each result.","method":"GET","path":"/v1/google/search","scope":"","tier":"extended","kind":"data","domain":"serp","call_template":"treg call scrapecreators.x.v1-google-search --query 'query=austen allred'","cost":{"type":"per_call","value":1,"currency":"credit","per":1,"unit":"call","source":"rate_card_api","source_url":"https://docs.scrapecreators.com/openapi.json","checked":"2026-07-28","confidence":"verified","usd":0.00188},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-07-28","docs_url":"https://docs.scrapecreators.com/google/search","has_example":true,"input":{"queryParams":{"query":{"type":"string","required":true,"note":"Search query","example":"austen allred"},"region":{"type":"string","required":false,"note":"2 letter country code, ie US, UK, CA, etc This will show results from that country","example":"US"},"date_posted":{"type":"string","required":false,"note":"Date posted","example":"last-hour"},"page":{"type":"number","required":false,"note":"Page number to retrieve. Must be between 1 and 11; page 12 or greater returns a 400 response.","example":"1"}}},"test_request":{"queryParams":{"query":"austen allred"}},"observed":{"samples":32942,"decided":19616,"ok_rate":0.994,"p50_ms":null,"p95_ms":null,"last_ok_days":0,"hit_rate":1.0,"hit_samples":15641}},{"id":"semrush.google.serp.organic","provider":"semrush","provider_display":"Semrush","name":"Google organic results by keyword — top 100 domains, URLs","summary":"List the domains and URLs ranking in Google's top 100 organic results for a keyword","method":"GET","path":"/","scope":"any_account","tier":"core","kind":"data","domain":"serp","call_template":"treg call semrush.google.serp.organic --query type=phrase_organic --query phrase=seo --query database=us","cost":{"type":"per_result","value":10,"currency":"unit","per":1,"unit":"api_unit","source":"docs","source_url":"https://www.semrush.com/api-documentation/","checked":"2026-07-28","confidence":"documented","note":"10 API units per LINE returned (50 units per line for historical data). One ranking URL = one line, so a full top-100 pull costs 1,000 units.","usd":null},"async":null,"platform_eligible":false,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":null,"docs_url":"https://developer.semrush.com/api/v3/analytics/keyword-reports/#organic-results","has_example":false,"input":{"queryParams":{"type":{"type":"string","required":true,"example":"phrase_organic"},"phrase":{"type":"string","required":true,"note":"the keyword whose SERP you want","example":"seo"},"database":{"type":"string","required":true,"example":"us"},"display_limit":{"type":"integer","required":false,"note":"COST DIAL — one line per ranking URL; 10 gives the first page of results","example":10},"display_offset":{"type":"integer","required":false},"display_sort":{"type":"string","required":false},"display_filter":{"type":"string","required":false},"display_date":{"type":"string","required":false,"note":"YYYYMM15 for a past month; historical requests bill at 50 units/line"},"export_columns":{"type":"string","required":false,"note":"default Dn,Ur,Fk,Fp. Dn=ranking domain, Ur=ranking URL, Fk=SERP features present, Fp=SERP features the URL occupies","example":"Dn,Ur,Fk,Fp"},"export_escape":{"type":"integer","required":false}},"note":"CSV response. This is Semrush's DATABASE view of the SERP, not a live scrape — positions come\nfrom Semrush's last crawl of that keyword in that regional database, so it is cheaper and\nfaster than a live SERP API but can lag by days. Use a live SERP provider when freshness matters.\n"},"test_request":null,"observed":{"samples":0,"decided":0,"ok_rate":null,"p50_ms":null,"p95_ms":null,"last_ok_days":null,"hit_rate":null,"hit_samples":0}},{"id":"serpapi.google.serp.organic","provider":"serpapi","provider_display":"SerpApi","name":"Google organic search results for a query","summary":"Live Google organic results for a keyword — position, title, URL, snippet, by location","method":"GET","path":"/search","scope":"any_account","tier":"core","kind":"data","domain":"serp","call_template":"treg call serpapi.google.serp.organic --query engine=google --query q=coffee","cost":{"type":"per_success","value":0.015,"currency":"USD","per":1,"unit":"call","source":"docs","source_url":"https://serpapi.com/pricing","checked":"2026-07-28","confidence":"documented","note":"1 search. $0.015 at the entry-level paid Developer plan ($75 / 5,000 searches); $0.010 on Production, $0.025 on Starter. Failed and cached searches are free.","usd":0.015},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-07-28","docs_url":"https://serpapi.com/search-api","has_example":true,"input":{"queryParams":{"engine":{"type":"string","required":true,"note":"the engine selector — must be this literal string","example":"google"},"q":{"type":"string","required":true,"note":"the search query; Google search operators work here","example":"coffee"},"location":{"type":"string","required":false,"note":"city-level origin of the search, e.g. \"Austin, Texas, United States\". Mutually exclusive with uule and with lat/lon"},"uule":{"type":"string","required":false,"note":"Google's encoded location, as an alternative to `location`"},"lat":{"type":"number","required":false,"note":"latitude; requires lon and a matching gl"},"lon":{"type":"number","required":false,"note":"longitude; requires lat"},"radius":{"type":"integer","required":false,"note":"metres around lat/lon; 1-199 on desktop, 1-1000 on mobile"},"google_domain":{"type":"string","required":false,"note":"default google.com; e.g. google.co.uk"},"gl":{"type":"string","required":false,"note":"country code for the search, e.g. us, uk","example":"us"},"hl":{"type":"string","required":false,"note":"interface language code, e.g. en","example":"en"},"cr":{"type":"string","required":false,"note":"restrict to countries, e.g. countryUS; multiple joined by |"},"lr":{"type":"string","required":false,"note":"restrict to languages, e.g. lang_en; multiple joined by |"},"device":{"type":"string","required":false,"note":"desktop (default) | tablet | mobile"},"start":{"type":"integer","required":false,"note":"result offset for pagination — 0, 10, 20 … This is how you page; see the note about `num`","example":0},"tbm":{"type":"string","required":false,"note":"switches the Google vertical: isch (images), vid, nws, shop, lcl, pts"},"tbs":{"type":"string","required":false,"note":"advanced Google filters, e.g. date range"},"safe":{"type":"string","required":false,"note":"active | off"},"nfpr":{"type":"string","required":false,"note":"1 disables Google's auto-correction to a different spelling"},"filter":{"type":"string","required":false,"note":"0 turns off Google's similar-results and omitted-results filters"}},"note":"Answers arrive in `organic_results`; the same response may also carry `knowledge_graph`,\n`local_results`, `related_questions`, `related_searches` and `pagination`.\n`num` IS NOT DOCUMENTED for this engine — Google dropped it upstream and SerpApi's google\nparameter list does not include it. Page with `start`, not `num`; sending `num` is not a\nsupported way to widen a page.\n"},"test_request":{"queryParams":{"engine":"google","q":"coffee"}},"observed":{"samples":3216,"decided":3207,"ok_rate":0.9972,"p50_ms":null,"p95_ms":null,"last_ok_days":0,"hit_rate":1.0,"hit_samples":1830}},{"id":"serpapi.x.google-light","provider":"serpapi","provider_display":"SerpApi","name":"Google organic results for a query — fast, trimmed","summary":"A faster, trimmed-down variant of the main Google organic engine — same query grammar, smaller payload","method":"GET","path":"/search","scope":"","tier":"extended","kind":"data","domain":"serp","call_template":"treg call serpapi.x.google-light --query engine=google_light --query q=coffee","cost":{"type":"per_success","value":0.015,"currency":"USD","per":1,"unit":"call","source":"docs","source_url":"https://serpapi.com/pricing","checked":"2026-07-28","confidence":"documented","usd":0.015},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-07-28","docs_url":"https://serpapi.com/google-light-api","has_example":true,"input":{"queryParams":{"engine":{"type":"string","required":true,"example":"google_light"},"q":{"type":"string","required":true,"example":"coffee"},"gl":{"type":"string","required":false,"example":"us"},"hl":{"type":"string","required":false,"example":"en"}},"note":"sibling of engine=google (see serpapi.google.serp.organic in core); answers arrive in `organic_results`."},"test_request":{"queryParams":{"engine":"google_light","q":"coffee"}},"observed":{"samples":649,"decided":648,"ok_rate":1.0,"p50_ms":null,"p95_ms":null,"last_ok_days":0,"hit_rate":1.0,"hit_samples":598}},{"id":"serpstat.google.serp.organic","provider":"serpstat","provider_display":"Serpstat","name":"Google organic results by keyword — ranking URLs, titles","summary":"URLs ranking in Google's top results for a keyword, with position, title and snippet","method":"POST","path":"/","scope":"any_account","tier":"core","kind":"data","domain":"serp","call_template":"treg call serpstat.google.serp.organic --method POST --data '{\"method\":\"SerpstatKeywordProcedure.getKeywordTop\",\"params\":\"\",\"params.keyword\":\"seo\",\"params.se\":\"g_us\"}'","cost":{"type":"per_result","value":1,"currency":"credit","per":1,"unit":"row","source":"docs","source_url":"https://serpstat.com/pay/","checked":"2026-07-28","confidence":"documented","note":"1 API credit per returned SERP row — `size` is the cost dial, and an empty result still bills the 1-credit minimum.","usd":0.0005},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":null,"docs_url":"https://api-docs.serpstat.com/docs/serpstat-public-api/env4osjb1ev9c-get-keyword-top","has_example":false,"input":{"bodyType":"json","body":{"method":{"type":"string","required":true,"example":"SerpstatKeywordProcedure.getKeywordTop"},"params":{"type":"object","required":true},"id":{"type":"string","required":false,"example":"1"},"params.keyword":{"type":"string","required":true,"note":"the keyword whose SERP you want","example":"seo"},"params.se":{"type":"string","required":true,"note":"search database","example":"g_us"},"params.size":{"type":"integer","required":false,"note":"COST DIAL — rows to return, max 1,000","example":10},"params.filters":{"type":"object","required":false,"note":"top_size (how deep into the SERP to look, max 100), position / position_from / position_to, and url, exact_url, domain, minus_domain, subdomain to restrict to one site"}},"note":"This is Serpstat's DATABASE view of the SERP, not a live scrape — positions come from\nSerpstat's last crawl of that keyword in that `se` database, so it is cheap and fast but can\nlag. Use a live SERP provider when freshness matters.\n`SerpstatKeywordProcedure.getKeywordFullTop` returns the same SERP with the full element set.\nRESPONSE SHAPE: rows are nested one level deeper than elsewhere in this file — they arrive\nat `result.data.top[]`, not `result.data[]`.\n"},"test_request":null,"observed":{"samples":2269,"decided":2268,"ok_rate":0.9996,"p50_ms":null,"p95_ms":null,"last_ok_days":0,"hit_rate":null,"hit_samples":0}}],"related_capabilities":[{"endpoint_id":"treg.google.keywords.ideas","capability":"google.keywords.ideas","does":"Get related keyword ideas"},{"endpoint_id":"treg.google.keywords.trends","capability":"google.keywords.trends","does":"Keyword popularity over time (Google Trends or a trends index)"},{"endpoint_id":"treg.google.keywords.volume","capability":"google.keywords.volume","does":"Keyword volume, CPC & competition"},{"endpoint_id":"treg.google.serp.local","capability":"google.serp.local","does":"Get Google Local Finder (local pack) results for a keyword"},{"endpoint_id":"treg.google.serp.maps","capability":"google.serp.maps","does":"Get Google Maps results for a keyword and location"}],"routing":{"contract":{"identity":[["q"]],"output":{"results":{"type":"list","required":true,"note":"the provider's own organic result rows (title, link/url, snippet…) — shapes differ per provider"},"count":{"type":"int"}},"miss":"results == []","derive":{}},"plan":[{"endpoint_id":"scrapecreators.x.v1-google-search","accepts":[["q"]],"usd":0.00188,"hit_rate":1.0,"usd_per_hit":0.00188,"works":0.994},{"endpoint_id":"dataforseo.google.serp.organic","accepts":[["q"]],"usd":0.002,"hit_rate":1.0,"usd_per_hit":0.002,"works":1.0},{"endpoint_id":"dataforseo.x.serp-google-organic-live-advanced","accepts":[["q"]],"usd":0.004,"hit_rate":1.0,"usd_per_hit":0.004,"works":1.0},{"endpoint_id":"serpapi.google.serp.organic","accepts":[["q"]],"usd":0.015,"hit_rate":1.0,"usd_per_hit":0.015,"works":0.9972},{"endpoint_id":"serpapi.x.google-light","accepts":[["q"]],"usd":0.015,"hit_rate":1.0,"usd_per_hit":0.015,"works":1.0}],"also":[{"endpoint_id":"cloro.google.serp.organic","usd":0.0056},{"endpoint_id":"semrush.google.serp.organic","usd":null},{"endpoint_id":"serpstat.google.serp.organic","usd":0.0005}],"headers":{"X-Treg-Route-Waterfall":"on by default: a miss tries the next provider; 0 = stop at the first miss","X-Treg-Route-Max-Cost":"USD ceiling for the whole call (default 1.00)","X-Treg-Route-Prefer":"provider[,…]","X-Treg-Route-Exclude":"provider[,…]","X-Treg-Route-Strict-Filters":"1 = never call a provider that cannot apply a filter you sent (answers 422, nothing charged); off by default — the answer names what was ignored in X-Treg-Ignored-Filters"}},"call_template":"treg call treg.google.serp.organic --method POST --data '{\"q\":\"…\"}'","example_response":null,"hints":["treg call treg.google.serp.organic --method POST --data '{\"q\":\"…\"}' # run it — key injected server-side","treg catalog get cloro.google.serp.organic # the same job from cloro"]}