{"uid":"cap_gqOlK55FAIpsuRETUzBgE","slug":"serp-history-api-archived-google-search-results-by-keyword-3f8cfa1a","name":"SERP History API – Archived Google Search Results by Keyword","description":"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.","url":"https://seo.openverbs.com/v1/serp-history?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mpcnELHJIhkXXoMDKGxmq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns archived Google SERP snapshots for a keyword over the past year, including ranked organic titles, URLs, domains, observation dates, and SERP feature types.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Competitive ranking history audit","prompt":"Show me who was ranking on Google for 'CRM software for small business' in the United States over the past year — I want to see the organic titles and URLs for each archived snapshot, up to 10 results each."},{"title":"SERP feature tracking for content strategy","prompt":"Pull the historical Google SERP snapshots for 'how to lose weight fast' in English from January to September this year so I can see what SERP features and domains kept appearing at the top."},{"title":"Brand keyword visibility check","prompt":"I need to see archived Google search results for 'Salesforce alternatives' in the US for the last 12 months — give me up to 15 organic results per snapshot so I can see when my competitor first showed up."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T07:20:46.812Z","isFirstParty":false,"canonicalSlug":"serp-history-api-archived-google-search-results-by-keyword-3f8cfa1a"}