{"uid":"cap_miI-zlUldo5cG0XLj8ZEv","slug":"seo-historical-rank-lookup-ac6fbf92","name":"SEO Historical Rank Lookup","description":"Historical rank overview API - a monthly time series of a domain's Google organic and paid visibility: ranked keyword count, estimated traffic (ETV), traffic cost and position buckets (pos1/top3/top10/top100) for each month. For tracking a site's SEO trajectory, spotting traffic drops/recoveries and competitor trend analysis. Unknown domain returns an empty series.","url":"https://seo.openverbs.com/v1/historical-rank?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"target":{"type":"string","maxLength":253,"minLength":3,"description":"Bare domain, e.g. stripe.com (scheme, www and path are stripped)."},"languageCode":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"Language code (2-letter). Defaults to en."},"locationCode":{"type":"integer","description":"DataForSEO location code. Defaults to 2840 (United States)."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mf7cok-TYhj4JMd-FjtWG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the historical Google search ranking position for a domain across time, by language and location","exampleAgentPrompt":"Can you pull up the historical Google search ranking for shopify.com in the United States — I want to see how their rank has changed over time?","exampleUseCases":[{"title":"Post-campaign SEO ranking audit","prompt":"We launched a big SEO push for acme.com six months ago — can you pull the historical Google ranking data for acme.com in the US so I can see whether their position actually improved after the campaign?"},{"title":"Competitor rank trend analysis","prompt":"I want to understand how our competitor notion.com has ranked on Google in the UK over time — can you get me the historical rank data for notion.com using language code 'en' and UK location?"},{"title":"International SEO benchmarking","prompt":"Can you check the historical Google ranking history for shopify.com in France — use language code 'fr' and the DataForSEO location code for France — so I can see how their French-market SEO has trended?"}],"resultDescription":"Returns historical Google search ranking positions for the specified domain, showing how its SERP standing has changed over time for the given language and geographic market. Typically includes rank data points across a time series, enabling trend analysis and campaign impact assessment.","failureModes":["Domain not found or has no ranking history — returns empty or null result","Invalid domain format (with scheme or path included) — API strips www/scheme but may reject malformed input","Invalid language code (not 2-letter ISO) — schema validation error","Invalid or unsupported DataForSEO location code — may return error or fall back to default","No historical data available for that domain/location/language combination","Payment failure via x402 protocol — call not completed"],"whenToPreferThis":"Choose this endpoint when you need time-series Google ranking history for a specific domain, particularly for tracking SEO progress after campaigns, auditing competitor rank trajectories, or benchmarking domain authority changes in specific geographic markets. It is backed by DataForSEO data and supports per-country and per-language scoping, making it superior to generic rank checkers when international SEO intelligence is needed. Prefer this over the domain traffic overview endpoint when you specifically want rank position history rather than traffic volume estimates.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:36:58.778Z","isFirstParty":false,"canonicalSlug":"seo-historical-rank-lookup-ac6fbf92"}