Live Google top results
serp_top_resultsRead-only
Live Google SERP for query. Returns the top N organic results
plus a summary of which SERP features are present (Knowledge Panel,
Map Pack, Featured Snippet, People Also Ask, related searches).
AI Overview is not measured (always null), and for some countries
(seen for "tr") no features come back at all: then
features.feature_data_available is false and the fields are null.
Use this when GSC tells you the position but you also need to know WHO is ranking above you, or whether Map Pack / Shopping / Featured Snippet are eating clicks despite a stable position.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| num | No | number of organic results, 1..100 (default 10). | |
| query | Yes | Google search query. | |
| device | No | "desktop" or "mobile". Different SERP features per device. | desktop |
| country | No | ISO 3166 country code (us, tr, de, ...). SERPs differ per country - use the country your real users search from. | tr |
| language | No | ISO 639 language code (en, tr, de, ...). | en |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||