{"uid":"cap_NZ5X3Wf5jPuJhIGzFTZ_2","slug":"google-trends-interest-over-time-5d67cb01","name":"Google Trends Interest Over Time","description":"Google Trends interest over time for a keyword — search popularity worldwide or for one country (geo) over a timeframe from the past hour to 2004-present (default: monthly since 2004), with ready-to-call links to the other Google Trends routes. For keyword research, SEO and demand trend analysis.","url":"https://google-trends.use.x402atlas.com/trend?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","default":"bitcoin","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":"2004_present","description":"New parameter. Time window: 2004_present monthly, past_12_months/past_5_years weekly, past_30_days/past_90_days daily, shorter windows hourly or finer"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["keyword","geo","timeframe","data_source","queried_at","series"],"properties":{"geo":{"type":"string","description":"Country actually served, or worldwide"},"notice":{"type":"string","description":"Present only when a fallback served worldwide 2004_present instead of the requested geo/timeframe"},"series":{"type":"array","items":{"type":"object","required":["date","value"],"properties":{"date":{"type":"string","format":"date","description":"ISO date (YYYY-MM-DD)"},"value":{"type":"integer","description":"Relative search-popularity index"},"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"},"see_also":{"type":"array","items":{"type":"object","required":["endpoint","description","params"],"properties":{"params":{"type":"array","items":{"type":"string"},"description":"Query params that route accepts"},"endpoint":{"type":"string","format":"uri"},"description":{"type":"string","maxLength":64}}},"description":"Follow-up routes for the same 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 only serves the worldwide 2004_present series — compare geo/timeframe with what you asked for"},"related_topics_url":{"type":"string","format":"uri","description":"Ready-to-call /related-topics URL for the same keyword"},"related_queries_url":{"type":"string","format":"uri","description":"Ready-to-call /related-queries URL for the same keyword"},"interest_by_region_url":{"type":"string","format":"uri","description":"Ready-to-call /interest-by-region URL for the same keyword"}}}}}}},"responseSchema":{"type":"json","example":{"series":[{"date":"2026-05-01","value":78}],"keyword":"bitcoin","queried_at":"2026-06-05T12:00:00Z"}},"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":"1.00","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/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_KLUFRhZ-9OtMMn9ima8Il","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 worldwide monthly search interest data for a keyword as a time series from Google Trends","exampleAgentPrompt":"Can you pull the Google Trends interest-over-time data for the keyword 'electric bikes' worldwide so I can see how search popularity has trended over recent months?","exampleUseCases":null,"resultDescription":"A monthly time series of worldwide search interest scores (0–100) for the specified keyword, reflecting relative search popularity over time from Google Trends","failureModes":["Missing required 'keyword' query parameter returns a 400 validation error","Keyword with no Google Trends data returns an empty or zero-value series","Payment not included or insufficient USDC results in a 402 Payment Required response","Very long or unsupported keyword strings may return an error","Rate limiting or upstream Google Trends API unavailability may cause 5xx errors"],"whenToPreferThis":"Choose this endpoint when you need worldwide monthly search interest trend data for a specific keyword — ideal for SEO keyword research, content planning, demand validation, and market trend analysis. Use this over regional endpoints when you want global aggregate data rather than country-specific breakdowns.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":40,"lastUsedAt":"2026-07-18T01:05:27.732Z","lastSuccessfullyRanAt":"2026-06-29T22:38:07.018Z","lastHealthCheckAt":"2026-10-30T15:38:02.731Z","isFirstParty":false,"canonicalSlug":"google-trends-interest-over-time-5d67cb01"}