{"uid":"cap_u2zB5ZoItr6CIH1m9AJrw","slug":"google-trends-interest-by-region-f1427195","name":"Google Trends Interest by Region","description":"Google Trends interest by region for a keyword. Returns the subregional breakdown of Google Trends search interest inside a country - by state, province, or region - each ranked 0-100 relative to the strongest region. For regional demand mapping, geo targeting, and finding where a keyword over-indexes before spending on it.","url":"https://api.kadec0.xyz/v1/interest-by-region","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","geo"],"properties":{"geo":{"type":"string","description":"ISO-3166 alpha-2 country code, e.g. US, GB, DE, JP (213 countries supported)"},"keyword":{"type":"string","description":"the search term"},"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.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wI4kG0i0AIkIHXSEc40Im","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns Google Trends subregional interest scores (0–100) for a keyword within a specified country, broken down by state or region.","exampleAgentPrompt":"Show me which US states are most interested in 'electric vehicles' on Google Trends over the past 12 months — give me the regional breakdown scored 0 to 100.","exampleUseCases":[{"title":"Regional market entry research","prompt":"I'm thinking about launching a fitness app — which US states show the highest Google search interest in 'home workout' over the past 12 months? Give me the state-by-state breakdown."},{"title":"Political sentiment mapping by region","prompt":"Which German states are searching for 'climate change' the most on Google right now? Show me the regional interest breakdown over the past 30 days."},{"title":"Retail product demand by geography","prompt":"I want to know where in the UK people are searching for 'Black Friday deals' the most — can you pull the Google Trends regional scores for that keyword in GB?"}],"resultDescription":"Returns a ranked list of subregions (states, provinces, or equivalent) within the specified country, each with an interest score from 0 to 100, where 100 represents the region with the highest relative search interest. Also includes metadata such as granularity of the time series bucket (hourly, daily, or weekly depending on the timeframe selected).","failureModes":["Missing required 'keyword' or 'geo' parameter returns a 400 validation error","Invalid or unsupported country code for 'geo' may return empty results or an error","Very obscure keywords with near-zero search volume may return all-zero scores","Rate limiting or upstream Google Trends throttling may cause intermittent failures","Extremely short timeframes (e.g. past_hour) may yield sparse or empty regional data"],"whenToPreferThis":"Choose this endpoint when you need geographic distribution of search interest within a country — i.e., which states or regions are driving interest in a keyword — rather than overall trend over time. Ideal for market segmentation, regional campaign targeting, or geographic demand analysis. Prefer this over global-level trend APIs when the use case is intra-country comparison.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:36:00.012Z","isFirstParty":false}