{"uid":"cap_Ps-ENky32FKiIprxMzGKT","slug":"google-trends-interest-over-time-b92770b0","name":"Google Trends Interest Over Time","description":"Google Trends interest over time for a keyword. Returns Google Trends search interest as a dated series indexed 0-100: weekly points across the default past 12 months, daily points for 30- and 90-day windows, and windows from the past hour back to 2004, with optional country targeting. For keyword trend analysis, search demand seasonality, and SEO keyword research.","url":"https://api.kadec0.xyz/v1/trend","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","required":["keyword"],"properties":{"geo":{"type":"string","description":"ISO-3166 alpha-2 country code, e.g. US, GB, DE, JP (213 countries supported); omit for worldwide"},"keyword":{"type":"string","description":"the search term to chart"},"timeframe":{"enum":["2004_present","past_12_months","past_30_days","past_4_hours","past_5_years","past_7_days","past_90_days","past_day","past_hour"],"type":"string","default":"past_12_months","description":"time window. Each response reports its own bucket size in `granularity`: past_30_days and past_90_days return a daily series, past_12_months and past_5_years weekly, windows under a day hourly"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"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":"1.00","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"healthy","priceObserved":{"p10Cents":"5.0000","medianCents":"5.0000","p90Cents":"5.0000","minCents":"5.0000","maxCents":"5.0000","p95Cents":"5.0000","sampleCount":1,"varies":false,"failureChargeRate":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_jShFxD1X58nSxZ63qJWNK","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 a dated time series (indexed 0–100) of Google search interest for a keyword, with configurable time window and optional country filter.","exampleAgentPrompt":"Can you pull the Google Trends interest over time for 'electric vehicles' in the US over the past 12 months and show me how interest has changed week by week?","exampleUseCases":[{"title":"Seasonal demand planning for a product","prompt":"Show me the Google Trends interest over time for 'sunscreen' in the US over the past 5 years — I want to see the seasonal spikes so I can plan inventory."},{"title":"Tracking a brand's search momentum","prompt":"Pull the daily Google Trends data for 'OpenAI' worldwide over the past 30 days — I want to see if search interest spiked after any announcements."},{"title":"Geo-specific market research","prompt":"Get the Google Trends interest over time for 'electric scooter' in Germany for the past 90 days — I'm evaluating whether there's enough consumer interest there to launch."}],"resultDescription":"A dated time series of interest scores from 0 to 100 for the specified keyword, where 100 represents peak popularity. Each data point corresponds to a time bucket whose size depends on the timeframe (hourly for sub-day windows, daily for 30/90-day windows, weekly for 12-month/5-year windows). The response also includes a granularity field indicating the bucket size used.","failureModes":["Missing required 'keyword' parameter returns a validation error","Invalid or unsupported country code in 'geo' returns an error or empty result","Keyword with no search data in the selected window may return all-zero series","Payment failure (x402) if USDC balance is insufficient — call is not executed","Rate limiting or upstream Google Trends unavailability may cause 5xx errors"],"whenToPreferThis":"Use this endpoint when you need a normalized, time-series view of Google search interest for a specific keyword, especially when you require country-level filtering or flexible time windows from the past hour all the way back to 2004. Prefer this over general web search endpoints when the goal is trend analysis, seasonality detection, or interest tracking rather than finding specific web pages or documents.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-09-09T08:33:33.129Z","lastSuccessfullyRanAt":"2026-09-09T08:33:33.129Z","lastHealthCheckAt":"2026-09-15T03:21:03.019Z","isFirstParty":false}