{"uid":"cap_8QLYOOUFzNoxDgb7H-W3h","slug":"spyfu--f560939f","name":"SpyFu Organic Ranking History API","description":"Ranking history research","url":"https://spyfu.mpp.tempo.xyz/apis/organic_history_api/v2/*?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["__pentest_poisoned_at"],"properties":{"__pentest_poisoned_at":{"type":"string","description":"VULN-TEST: schema-poisoning canary — should not be here"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["seo","ppc","keyword-research","competitor-analysis","ads","data","search"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.03/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mi6FQsG2s7tkK5ZRYUL_9","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"SpyFu","brandSlug":"spyfu","brandBaseUrl":"https://spyfu.com","brandDocsUrl":"https://developer.spyfu.com","whatItDoes":"Retrieves historical organic search ranking data for domains or keywords over time using SpyFu's 18+ year database","exampleAgentPrompt":"Pull the organic ranking history for neil patel dot com from SpyFu — I want to see how their search positions have changed over the past few years.","exampleUseCases":[{"title":"Analyze competitor SEO recovery strategy","prompt":"Check the ranking history for our main competitor's domain over the last 3 years — I need to understand when they dropped in rankings and how they've recovered, so we can learn from their approach."},{"title":"Track keyword position volatility patterns","prompt":"Show me the ranking history for the keyword 'project management software' — I want to see which domains have held top positions consistently versus ones that have fluctuated a lot over the years."},{"title":"Identify when a site lost SEO dominance","prompt":"Pull the historical rankings for Amazon's domain — specifically around 2019 to 2021 — I'm trying to figure out if there was a major algorithm update that impacted them and when they recovered."}],"resultDescription":"Returns historical organic search ranking positions for a given domain or keyword, showing how rankings have changed over time with SpyFu's historical dataset spanning 18+ years.","failureModes":["Domain not found in SpyFu's database — returns empty or null ranking history","Invalid domain format causing a 400 bad request","Date range out of bounds for available historical data","Rate limiting or authentication failure returning 401/403","No ranking history available for low-traffic or new domains"],"whenToPreferThis":"Use this endpoint when you need historical SEO ranking data — specifically tracking how a domain's organic search positions have evolved over time. Prefer this over current-snapshot endpoints when trend analysis, timeline research, or long-term competitor tracking is the goal. SpyFu's 18+ year dataset makes this especially valuable for longitudinal SEO research.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:33:39.953Z","isFirstParty":false,"canonicalSlug":"spyfu--f560939f"}