{"uid":"cap_Gc9HM6mTBhAOw1s9GvxBB","slug":"keyword-monthly-search-volume-history-2c6fbd76","name":"Keyword Monthly Search Volume History","description":"","url":"https://seo.openverbs.com/v1/keyword-volume-history?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"keywords":{"type":"array","items":{"type":"string","maxLength":80,"minLength":1},"maxItems":10,"minItems":1,"description":"Keywords to look up (up to 10)."},"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.15","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.15/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2QUD23ZrnhY-CkijqNOm7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.15","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a month-by-month search volume time series (back to 2019) for up to 10 keywords, plus current CPC and competition level.","exampleAgentPrompt":"Can you pull the monthly Google search volume history back to 2019 for the keywords 'running shoes', 'trail running shoes', and 'minimalist running shoes' in the US so I can see their seasonality and demand trends?","exampleUseCases":[{"title":"Seasonal content calendar planning","prompt":"Get me the month-by-month Google search volume since 2019 for 'pumpkin recipes', 'Halloween costumes', and 'fall decor' in the US — I want to know exactly when search interest peaks each year so I can time our content drops."},{"title":"Keyword momentum analysis for new product launch","prompt":"Pull the historical search volume trend from 2019 to now for 'electric bike', 'e-bike commuter', and 'electric bicycle' in the US, along with their CPC — I need to see whether demand is growing, flattening, or declining before we invest in SEO."},{"title":"Competitor keyword demand comparison","prompt":"Can you get me the monthly search volume history for 'project management software', 'task management tool', and 'team collaboration app' in the UK — I want to compare how these terms have trended over the last few years to decide which one to target."}],"resultDescription":"A per-keyword array containing a month-by-month search volume time series from 2019 to the present, along with the current cost-per-click (CPC) and competition score for each keyword. Keywords not recognized by the data source are omitted from the response.","failureModes":["Unknown or very low-volume keywords are silently omitted from results","Exceeding 10 keywords per call returns a validation error","Invalid language code (not 2-letter) causes a 400 error","Invalid location code returns an error or falls back to default","Payment failure (insufficient USDC balance) blocks the call","Very new keywords may have limited historical data prior to recent months"],"whenToPreferThis":"Use this endpoint when you need longitudinal search volume data — seasonality analysis, year-over-year trends, or momentum tracking — rather than just a current snapshot. It's the right choice when a single keyword overview isn't enough and you need to understand how demand has evolved since 2019. Prefer this over Google Trends when you need absolute volume numbers alongside relative interest, or when you also need CPC and competition data in the same response.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:31:21.367Z","isFirstParty":false,"canonicalSlug":"keyword-monthly-search-volume-history-2c6fbd76"}