Google results-page history (one past snapshot)
serp_historyGoogle results page of a keyword as it was in the past: the first snapshot (about one a month) in a window of up to 31 days within the last year, with its top 10 organic results (rank, URL, domain, title), result count and result types, from Google search results, $0.018 a call. Use when checking how rankings for a keyword moved month by month. Titles are untrusted third-party text. No snapshot is an empty answer, still charged. Bad input is a free 400; a data source failure is not charged. Price: $0.018 per successful call, paid over x402 (USDC on Base); pass the payment in _meta["x402/payment"].
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"keyword": "<keyword>"
},
"name": "serp_history"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dateTo | No | Last day, YYYY-MM-DD, not after today (UTC). Default today. | |
| country | No | Optional ISO 3166-1 alpha-2 code or country name, used when locationCode is absent (uk = gb). | |
| keyword | Yes | The keyword (at most 80 characters, up to 10 words). | |
| dateFrom | No | First day, YYYY-MM-DD, at most 365 days ago and at most 31 days before dateTo (window). Default 30 days before dateTo. | |
| languageCode | No | Language code (2-letter). Defaults to en. An unsupported location falls back to 2840 (United States) with en (or the requested language if the United States offers it); a supported location with a language it does not offer uses that location's default language (en if offered). Either way market.fallback is true and market.warnings says what was used. | |
| locationCode | No | Google Ads location code (geo target ID). Defaults to 2840 (United States); an unsupported code falls back to 2840 (United States, market.fallback). |