{"uid":"cap_vpUNCH_fga9HvtTFUaq_J","slug":"spyfu-35d84474","name":"SpyFu Historic Rankings for Domain on Keywords","description":"GET /apis/organic_history_api/v2/historic/getHistoricRankingsForDomainOnKeywords","url":"https://spyfu.x402.paysponge.com/apis/organic_history_api/v2/historic/getHistoricRankingsForDomainOnKeywords","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","additionalProperties":true}},"additionalProperties":false}},"additionalProperties":false},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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":"down","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_VYFdIj7TnTu7pIqqnyAxU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x036CbD53842c5426634e7929541eC2318f3dCF7e","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves historical organic search rankings for a specific domain across a set of target keywords","exampleAgentPrompt":"Show me how example.com has historically ranked on SpyFu for the keywords 'project management software' and 'task tracking tool' — I want to see the ranking timeline for those specific terms.","exampleUseCases":null,"resultDescription":"Returns historical organic search ranking data for the specified domain on the given keywords, including ranking positions across time periods, showing how the domain's SERP position changed for each keyword.","failureModes":["Domain not found in SpyFu database returns empty or null rankings","Invalid or unrecognized keywords return no ranking history","Rate limit exceeded returns HTTP 429","Payment failure via x402 returns HTTP 402","Malformed query parameters return HTTP 400","Domain with no organic history returns empty result set"],"whenToPreferThis":"Use this endpoint when you need to analyze how a specific domain has ranked for particular, named keywords over historical time periods — as opposed to getting all keywords for a domain or current rankings only. Ideal for competitive research where you already know the keywords of interest and want to see ranking trajectory for a specific site.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:49:00.801Z","isFirstParty":false}