{"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: where in a country people search for it most — every state, province or region ranked 0-100 against the strongest one. For regional demand mapping, geo-targeting, local SEO and finding the markets where a keyword over-indexes before spending on ads.","url":"https://google-trends.use.x402atlas.com/interest-by-region?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":"US","maxLength":8,"description":"ISO-3166 alpha-2 country code, e.g. US, GB, DE, JP (213 countries supported); case-insensitive; also accepted as country; defaults to US"},"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","geo","queried_at","regions"],"properties":{"geo":{"type":"string","description":"Echoed country code, upper-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"},"trend_url":{"type":"string","format":"uri","description":"Ready-to-call /trend URL for the same keyword"},"queried_at":{"type":"string","format":"date-time","description":"UTC timestamp the upstream was queried"},"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"},"trend_over_time_url":{"type":"string","format":"uri","description":"Ready-to-call /trend-over-time URL for the same keyword"}}}}}}},"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-10-29T18:27:56.722Z","isFirstParty":false,"canonicalSlug":"google-trends-interest-by-region-3d1603ae"}