{"endpoint":{"id":"treg.google.serp.organic","provider":"treg","provider_display":"treg","name":"google.serp.organic — routed: best of 7 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":"serp","call_template":"treg call treg.google.serp.organic --method POST --data '{\"q\":\"…\"}'","cost":{"type":"per_success","value":0.00015,"currency":"USD","per":1,"unit":"call","source":"inferred","confidence":"documented","checked":null,"varies":true,"note":"NOT free: misses are billed too. the children's range $0.00015–$0.015 per hit, 0% markup; you pay the child that served AND every child tried before it that bills a miss (3 of 7 do), up to X-Treg-Route-Max-Cost (default $1 a call). X-Treg-Route-Exclude them, or X-Treg-Route-Waterfall: 0, to pay for one provider only","usd":0.00015},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":{"status":200,"means":"output.results == []"},"status":null,"status_note":null,"superseded_by":null,"verified":null,"added":null,"docs_url":"","has_example":false,"input":{"bodyType":"json","body":{"q":{"type":"str","required":false,"note":"identity key (part of q, ai_overview+q)"},"ai_overview":{"type":"bool","required":false,"note":"identity key (part of ai_overview+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} | {ai_overview, 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: <usd>, X-Treg-Route-Prefer / X-Treg-Route-Exclude: <provider>. The response is {output, raw, _treg: {served_by, tried}}; X-Treg-Served-By names the child."},"test_request":{"body":{"q":"…"}},"routed_children":["anyapi.google.serp.organic","crawl4ai.google.serp.organic","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":1745163,"decided":1745142,"ok_rate":0.9916,"p50_ms":null,"p95_ms":null,"last_ok_days":0,"hit_rate":null,"hit_samples":0},"reviews":{"teams":0,"samples":[{"usefulness":"not_useful","reason":"SERP call failed on identity; later CLI SERP worked and grounded the research","client":"mcp","month":"2026-10"},{"usefulness":"not_useful","reason":"Returned HTTP 402 insufficient_balance; no SERP rows delivered.","client":"mcp","month":"2026-09"}]}},"provider":{"service":"treg","display_name":"treg"},"siblings":[{"id":"anyapi.google.serp.organic","provider":"anyapi","provider_display":"AnyAPI","name":"Google Search","scope":"any_account","kind":"data","cost":{"type":"per_success","value":0.0009,"currency":"USD","unit":"call","reported_charge":{"path":"costUsd","unit":"usd"},"usd":0.0009},"platform_eligible":true,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-09-19","params":["autocorrect","cursor","gl","hl","limit","location","page","query","timeframe"],"observed":{"samples":1654791,"decided":1636654,"ok_rate":0.9474,"p50_ms":7001,"p95_ms":19737,"last_ok_days":0,"hit_rate":0.9115,"hit_samples":1635936},"reviews":{"teams":50,"share":{"useful":0.81,"partly":0.15,"not_useful":0.05}}},{"id":"cloro.google.serp.organic","provider":"cloro","provider_display":"cloro","name":"Google SERP — organic, PAA, local pack, AI Overview","scope":"any_account","kind":"data","cost":{"type":"per_call","value":7,"currency":"credit","per":1,"unit":"call","usd":0.0028},"platform_eligible":true,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-09-07","params":["query","url","gl","hl","location","uule","device","pages","include"],"observed":{"samples":47723,"decided":47511,"ok_rate":0.9759,"p50_ms":11250,"p95_ms":32012,"last_ok_days":0,"hit_rate":0.9861,"hit_samples":38339},"reviews":{"teams":25,"share":{"useful":0.91,"partly":0.08,"not_useful":0.01}}},{"id":"crawl4ai.google.serp.organic","provider":"crawl4ai","provider_display":"Crawl4AI","name":"Google organic results with true rank and page blocks","scope":"any_account","kind":"data","cost":{"type":"per_success","value":0.15,"currency":"credit","per":1,"unit":"page","usd":0.00015},"platform_eligible":true,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-10-09","params":["q","country","language","location","num","page","time","fresh","source"],"observed":{"samples":2073293,"decided":1891543,"ok_rate":0.9195,"p50_ms":2288,"p95_ms":9454,"last_ok_days":0,"hit_rate":0.9307,"hit_samples":1867789},"reviews":{"teams":50,"share":{"useful":0.86,"partly":0.08,"not_useful":0.06}}},{"id":"dataforseo.google.serp.organic","provider":"dataforseo","provider_display":"DataForSEO","name":"Google organic search results for a keyword, live","scope":"any_account","kind":"data","cost":{"type":"per_call","value":0.002,"currency":"USD","per":1,"unit":"call","display":{"unit":"call","variable":true},"usd":0.002,"display_usd":0.002,"display_unit":"call","display_suffix":"+","display_prefix":""},"platform_eligible":true,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-07-28","params":["keyword","location_code","location_name","language_code","depth","device","os"],"observed":{"samples":181430,"decided":180173,"ok_rate":0.9995,"p50_ms":8947,"p95_ms":24505,"last_ok_days":0,"hit_rate":1.0,"hit_samples":151497},"reviews":{"teams":50,"share":{"useful":0.82,"partly":0.1,"not_useful":0.09}}},{"id":"dataforseo.x.serp-google-organic-live-advanced","provider":"dataforseo","provider_display":"DataForSEO","name":"Google organic results for a keyword — full SERP features","scope":"","kind":"data","cost":{"type":"per_call","value":0.004,"currency":"USD","per":1,"unit":"call","usd":0.004},"platform_eligible":true,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-07-28","params":["keyword","location_code","language_code","depth","device","load_async_ai_overview","location_name","language_name","os","tag","stop_crawl_on_match","match_type","match_value","max_crawl_pages","search_param","remove_from_url","people_also_ask_click_depth","group_organic_results","calculate_rectangles","browser_screen_width","browser_screen_height","browser_screen_resolution_ratio","url","location_coordinate","se_domain","target","target_search_mode","find_targets_in","ignore_targets_in"],"observed":{"samples":148476,"decided":146493,"ok_rate":0.9996,"p50_ms":8232,"p95_ms":25780,"last_ok_days":0,"hit_rate":1.0,"hit_samples":118656},"reviews":{"teams":25,"share":{"useful":0.82,"partly":0.11,"not_useful":0.07}}},{"id":"limadata.google.serp.organic","provider":"limadata","provider_display":"LimaData","name":"Search the web","scope":"any_account","kind":"data","cost":{"type":"per_success","value":0.1,"currency":"credit","per":1,"unit":"call","usd":0.002},"platform_eligible":true,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-09-17","params":["query","page"],"observed":{"samples":19204,"decided":18869,"ok_rate":0.86,"p50_ms":689,"p95_ms":2408,"last_ok_days":0,"hit_rate":0.8053,"hit_samples":13378},"reviews":{"teams":0}},{"id":"litescrape.google.serp.organic","provider":"litescrape","provider_display":"Litescrape","name":"Search Google","scope":"any_account","kind":"data","cost":{"type":"per_success","value":0.00015,"currency":"USD","per":1,"unit":"call","usd":0.00015},"platform_eligible":true,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-09-29","params":["fast_mode","q","ludocid","kgmid","location","uule","lat","lon","radius","lsig","si","ibp","uds","color_scheme","google_domain","gl","hl","cr","lr","device","tbs","safe","nfpr","filter","pws","peek_pws","tbm","start","num","as_dt","as_epq","as_eq","as_lq","as_nlo","as_nhi","as_oq","as_q","as_qdr","as_rq","as_sitesearch","oq","gs_lp","sclient","timeout"],"observed":{"samples":245958,"decided":237379,"ok_rate":0.6303,"p50_ms":4095,"p95_ms":28954,"last_ok_days":0,"hit_rate":0.9601,"hit_samples":99205},"reviews":{"teams":5,"share":{"useful":0.83,"partly":0.13,"not_useful":0.03}}},{"id":"scrapecreators.x.v1-google-search","provider":"scrapecreators","provider_display":"ScrapeCreators","name":"Search Google by keyword — organic results","scope":"","kind":"data","cost":{"type":"per_call","value":1,"currency":"credit","per":1,"unit":"call","usd":0.00188},"platform_eligible":true,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-07-28","params":["query","region","date_posted","page"],"observed":{"samples":47924,"decided":20057,"ok_rate":0.9864,"p50_ms":1879,"p95_ms":4570,"last_ok_days":0,"hit_rate":1.0,"hit_samples":17092},"reviews":{"teams":5,"share":{"useful":0.9,"partly":0.1,"not_useful":0.0}}},{"id":"semrush.google.serp.organic","provider":"semrush","provider_display":"Semrush","name":"Google organic results by keyword — top 100 domains, URLs","scope":"any_account","kind":"data","cost":{"type":"per_result","value":10,"currency":"unit","per":1,"unit":"api_unit","usd":null},"platform_eligible":false,"status":null,"status_note":null,"superseded_by":null,"verified":null,"params":["type","phrase","database","display_limit","display_offset","display_sort","display_filter","display_date","export_columns","export_escape"],"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","scope":"any_account","kind":"data","cost":{"type":"per_success","value":0.015,"currency":"USD","per":1,"unit":"call","usd":0.015},"platform_eligible":true,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-07-28","params":["engine","q","location","uule","lat","lon","radius","google_domain","gl","hl","cr","lr","device","start","tbm","tbs","safe","nfpr","filter"],"observed":{"samples":15793,"decided":14064,"ok_rate":0.929,"p50_ms":1407,"p95_ms":54643,"last_ok_days":0,"hit_rate":1.0,"hit_samples":9584},"reviews":{"teams":0}},{"id":"serpapi.x.google-light","provider":"serpapi","provider_display":"SerpApi","name":"Google organic results for a query — fast, trimmed","scope":"","kind":"data","cost":{"type":"per_success","value":0.015,"currency":"USD","per":1,"unit":"call","usd":0.015},"platform_eligible":true,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-07-28","params":["engine","q","gl","hl"],"observed":{"samples":5317,"decided":4426,"ok_rate":0.9433,"p50_ms":7509,"p95_ms":35879,"last_ok_days":0,"hit_rate":1.0,"hit_samples":1742},"reviews":{"teams":5,"share":{"useful":0.2,"partly":0.4,"not_useful":0.4}}},{"id":"serpstat.google.serp.organic","provider":"serpstat","provider_display":"Serpstat","name":"Google organic results by keyword — ranking URLs, titles","scope":"any_account","kind":"data","cost":{"type":"per_result","value":1,"currency":"credit","per":1,"unit":"row","usd":0.0005},"platform_eligible":true,"status":null,"status_note":null,"superseded_by":null,"verified":null,"params":["method","params","id","params.keyword","params.se","params.size","params.filters"],"observed":{"samples":4339,"decided":4339,"ok_rate":0.5186,"p50_ms":1019,"p95_ms":1322,"last_ok_days":0,"hit_rate":0.3313,"hit_samples":3124},"reviews":{"teams":10,"share":{"useful":0.71,"partly":0.0,"not_useful":0.29}}}],"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.maps.reviews","capability":"google.maps.reviews","does":"List the Google Maps reviews of a place"},{"endpoint_id":"treg.google.serp.local","capability":"google.serp.local","does":"Get Google Local Finder (local pack) results for a keyword"}],"routing":{"contract":{"identity":[["q"],["ai_overview","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":"crawl4ai.google.serp.organic","accepts":[["q"]],"usd":0.00015,"hit_rate":0.9307,"usd_per_hit":0.00015,"works":0.9195},{"endpoint_id":"anyapi.google.serp.organic","accepts":[["q"]],"usd":0.0009,"hit_rate":0.9115,"usd_per_hit":0.0009,"works":0.9474},{"endpoint_id":"scrapecreators.x.v1-google-search","accepts":[["q"]],"usd":0.00188,"hit_rate":1.0,"usd_per_hit":0.00188,"works":0.9864},{"endpoint_id":"dataforseo.google.serp.organic","accepts":[["q"]],"usd":0.002,"hit_rate":1.0,"usd_per_hit":0.002,"works":0.9995},{"endpoint_id":"dataforseo.x.serp-google-organic-live-advanced","accepts":[["q"]],"usd":0.004,"hit_rate":1.0,"usd_per_hit":0.004,"works":0.9996},{"endpoint_id":"serpapi.google.serp.organic","accepts":[["q"]],"usd":0.015,"hit_rate":1.0,"usd_per_hit":0.015,"works":0.929},{"endpoint_id":"serpapi.x.google-light","accepts":[["q"]],"usd":0.015,"hit_rate":1.0,"usd_per_hit":0.015,"works":0.9433}],"also":[{"endpoint_id":"cloro.google.serp.organic","usd":0.0028},{"endpoint_id":"limadata.google.serp.organic","usd":0.002},{"endpoint_id":"litescrape.google.serp.organic","usd":0.00015},{"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 anyapi.google.serp.organic   # the same job from anyapi"]}