{"uid":"cap_4lsvmUFbhUFNMzYfDe5ft","slug":"google-trends-interest-over-time-6550ae99","name":"Google Trends Interest Over Time","description":"Google Trends interest over time for a keyword — search interest as a dated 0-100 series with country targeting (geo) and timeframe windows from the past hour back to 2004: daily points for 30/90-day windows, weekly for 12 months/5 years. For keyword trend analysis, search demand seasonality and SEO keyword research.","url":"https://google-trends.use.x402atlas.com/trend-over-time?utm_source=zero.xyz","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"],"type":"string"},"queryParams":{"type":"object","required":["keyword"],"properties":{"geo":{"type":"string","default":"worldwide","maxLength":8,"description":"ISO-3166 alpha-2 country code, e.g. US, GB, DE, JP (213 countries supported); case-insensitive; also accepted as country; omit for worldwide"},"keyword":{"type":"string","maxLength":100,"description":"Concise Google Trends seed term with meaningful search interest; not a question, instruction, or web-search request"},"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. Bucket size follows the window and is reported in granularity: past_30_days/past_90_days daily, past_12_months/past_5_years weekly, 2004_present monthly, shorter windows hourly or finer"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["keyword","geo","timeframe","granularity","data_source","queried_at","series"],"properties":{"geo":{"type":"string","description":"Location actually served: upper-cased country code, or worldwide"},"notice":{"type":"string","description":"Present only on a degraded fallback response; explains what was served instead"},"series":{"type":"array","items":{"type":"object","required":["date","value"],"properties":{"date":{"type":"string","format":"date","description":"UTC calendar date of the bucket (YYYY-MM-DD)"},"value":{"type":"integer","maximum":100,"minimum":0,"description":"Relative search-interest index, 100 = peak within the window"},"timestamp":{"type":"string","format":"date-time","description":"Bucket start as RFC3339 UTC — use this for sub-day windows"}}},"description":"Interest-over-time points in ascending time order"},"keyword":{"type":"string","description":"Echoed search keyword"},"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","description":"Window actually served"},"queried_at":{"type":"string","format":"date-time","description":"UTC timestamp the upstream was queried"},"data_source":{"enum":["primary","fallback"],"type":"string","description":"primary honors geo and timeframe; fallback can only serve the worldwide 2004_present monthly series — compare geo/timeframe with what you asked for"},"granularity":{"enum":["minute","hour","day","week","month",""],"type":"string","description":"Bucket size of the series; empty when the series has fewer than two points"}}}}}}},"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_nl4iUtRrID_xqwhSRPveD","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 0-100 relative search-interest time series for a keyword, with configurable country targeting and time window granularity (hourly to monthly).","exampleAgentPrompt":"Can you pull the Google Trends interest-over-time data for 'electric vehicles' in the US over the past 12 months? I want to see the weekly 0-100 index to understand seasonal demand patterns.","exampleUseCases":[{"title":"Seasonal SEO content planning","prompt":"Show me the Google Trends interest over time for 'pumpkin spice' in the US over the past 5 years — I want to see the weekly trend to understand when search demand peaks each year so I can time my content calendar."},{"title":"Emerging keyword demand monitoring","prompt":"Pull the daily Google Trends data for 'AI coding assistant' worldwide over the past 90 days — I want to see if search interest has been accelerating recently."},{"title":"Market entry timing research","prompt":"Get me the Google Trends interest-over-time series for 'electric scooter' in Germany over the past 12 months — I need the weekly index to see if there's growing consumer demand before we launch there."}],"resultDescription":"A JSON object containing the keyword, geo (country code or 'worldwide'), timeframe, granularity (hourly/daily/weekly/monthly), data source, query timestamp, and a 'series' array of date-value objects where each value is an integer 0-100 representing relative search interest at that point in time (100 = peak within the window). May include a 'notice' field if a degraded fallback response was served.","failureModes":["Keyword has insufficient search volume — returns zero or near-zero series","Invalid or unsupported country code — may return error or fall back to worldwide","Keyword too long (over 100 characters) — schema validation error","Timeframe enum value misspelled — request rejected","Rate limiting or payment failure — 402 or 429 response","Google Trends upstream unavailability — degraded or fallback response with notice field"],"whenToPreferThis":"Use this endpoint when you need a time-series view of search interest for a specific keyword — ideal for trend analysis, seasonality research, SEO content timing, and market demand tracking. Prefer this over the related-queries or interest-by-region endpoints when the user's primary question is 'how has interest changed over time?' rather than 'where is this popular?' or 'what related terms are rising?'. Choose this over generic SEO tools when you need raw, date-stamped Google Trends data with configurable geographic and time-window targeting at a per-call cost.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:32:22.128Z","isFirstParty":false,"canonicalSlug":"google-trends-interest-over-time-5d67cb01"}