# SERP History API – Archived Google Search Results by Keyword

> SERP History API – Archived Google Search Results by Keyword is a paid API for AI agents from seo.openverbs.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-29).

Returns archived Google SERP snapshots for a keyword over the past year, including ranked organic titles, URLs, domains, observation dates, and SERP feature types.

## Facts

- Endpoint: POST https://seo.openverbs.com/v1/serp-history?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/serp-history-api-archived-google-search-results-by-keyword-3f8cfa1a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gqOlK55FAIpsuRETUzBgE

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability serp-history-api-archived-google-search-results-by-keyword-3f8cfa1a -d '<json body>'
```

Example prompt: Pull up archived Google search results for the keyword 'best project management software' in the US from January 1 to June 30 of this year, showing the top 10 organic results per snapshot.

## When to prefer this

Use this endpoint when you need to look back at how Google SERPs looked for a specific keyword over the past year — e.g. for competitive audits, content gap analysis, or understanding historical rank dynamics. Prefer it over live rank-tracking APIs when historical snapshot data (even if sparse) is sufficient. Not suitable for real-time rank monitoring or current SERP scraping.

## Known failure modes

- No archived data found for the keyword — returns found=false
- dateFrom older than 365 days ago is rejected
- dateTo set to a future date is rejected
- keyword exceeds 80 characters — validation error
- locationCode not recognized — invalid location error
- limit exceeds 20 — validation error
- languageCode not a valid two-letter code — rejected

## How this service works

SERP history API: archived Google search results for one keyword over the past year, with observation dates, SERP feature types and ranked organic titles, URLs and domains. Coverage is sparse and may be months old, not a complete monthly series or current rank tracking. Returns available snapshots oldest-first; no data returns found=false.

## Output

An oldest-first array of available SERP snapshots for the keyword, each containing the observation date, SERP feature types present, and a ranked list of organic results (title, URL, domain) up to the requested limit. If no snapshots are found, returns found=false. Coverage is sparse and may be months old rather than a complete monthly series.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 10,
   "maximum": 20,
   "minimum": 1,
   "description": "Organic results per snapshot. Does not limit the number of archived snapshots."
  },
  "dateTo": {
   "type": "string",
   "format": "date",
   "description": "UTC end date, YYYY-MM-DD. Defaults to today; future dates are rejected."
  },
  "keyword": {
   "type": "string",
   "maxLength": 80,
   "minLength": 1,
   "description": "Keyword whose archived Google results to retrieve."
  },
  "dateFrom": {
   "type": "string",
   "format": "date",
   "description": "UTC start date, YYYY-MM-DD. Defaults to 365 days ago; older dates are rejected."
  },
  "languageCode": {
   "type": "string",
   "default": "en",
   "pattern": "^[A-Za-z]{2}$",
   "description": "Two-letter language code."
  },
  "locationCode": {
   "type": "integer",
   "default": 2840,
   "maximum": 9999999,
   "minimum": 1,
   "description": "DataForSEO location code; defaults to United States."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/serp-history-api-archived-google-search-results-by-keyword-3f8cfa1a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from seo.openverbs.com](https://www.zero.xyz/host/seo.openverbs.com/llms.txt)