{"uid":"cap_eZ9bgEezPGnbvyVDetv4n","slug":"google-trends-interest-by-region-3d1603ae","name":"Google Trends Interest by Region","description":"Google Trends interest by region for a keyword — search popularity by geography for geo-targeting, local SEO and market research.","url":"https://google-trends.use.x402atlas.com/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"],"type":"string"},"queryParams":{"type":"object","required":["keyword","country"],"properties":{"country":{"type":"string","maxLength":8,"description":"Country code, e.g. us (case-insensitive)"},"keyword":{"type":"string","maxLength":100,"description":"Concise Google Trends seed term with meaningful search interest; not a question, instruction, or web-search request"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["keyword","country","queried_at","regions"],"properties":{"country":{"type":"string","description":"Echoed country code, lower-cased"},"keyword":{"type":"string","description":"Echoed search keyword"},"regions":{"type":"array","items":{"type":"object","required":["region","value"],"properties":{"value":{"type":"integer","description":"Relative search-popularity index (0-100)"},"region":{"type":"string","description":"Subregion name"}}},"description":"Interest broken down by subregion within the country"},"queried_at":{"type":"string","format":"date-time","description":"UTC timestamp the upstream was queried"}}}}}}},"responseSchema":{"type":"json","example":{"country":"us","keyword":"bitcoin","regions":[{"value":100,"region":"California"}],"queried_at":"2026-06-05T12:00:00Z"}},"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_ly2z9d6kJC5b28_om8qhR","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 search interest scores broken down by geographic sub-region for a given keyword and country.","exampleAgentPrompt":"Show me the Google Trends interest by region for the keyword 'electric bikes' in the US — I want to see which states are searching for it most so I can plan my geo-targeting.","exampleUseCases":null,"resultDescription":"A list of geographic sub-regions (e.g. US states or country subdivisions) with their relative search interest scores (0–100) for the specified keyword, enabling geographic demand analysis and geo-targeting decisions.","failureModes":["Invalid or unsupported two-letter country code returns an error or empty result","Keyword with no regional data available returns an empty or sparse dataset","Rate limiting or payment failure returns a 402 or 429 error","Very niche or brand-new keywords may return zero-interest regions","Misspelled keyword may return results for an unintended term"],"whenToPreferThis":"Use this endpoint when you need geographic distribution of search demand for a specific keyword within a country — ideal for local SEO, geo-targeted ad campaigns, or market expansion research. Prefer this over the 'interest over time' endpoint when you need spatial rather than temporal analysis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:31:04.829Z","isFirstParty":false}