The taxonomy
Location resolves across six levels, each built on an established standard so it interoperates with other systems you use.| Level | Coverage |
|---|---|
| Region | Global |
| Subregion | Global |
| Country | Global |
| State / Province | United States only |
| County | United States only |
| City / Municipality | Global |
Coverage by channel
Location resolution is best effort, and how often it succeeds depends heavily on the channel.How location is resolved
News. Location reflects the publisher’s headquarters, typically resolved to country level. This is a signal about the outlet, not about where the story took place. A Washington-headquartered outlet covering a flood in Texas resolves to the US, not to Texas. Social. Location comes from the account’s self-reported or detected profile location, coerced into the taxonomy. Free-text entries like “Chi-town” or “NYC” are matched against an alternate-names list and resolved to their canonical entry. Reddit. Reddit has no location field, so location is inferred from geographically named subreddits: a post in a city or country subreddit resolves to that place. Posts outside geographic subreddits carry no location. Unresolvable locations aren’t labeled. The platform does not guess. A mention with no resolvable location is absent from geographic breakdowns.Time coverage
Normalized location is available on mentions published on or after July 1, 2026. Mentions published before that date carry no normalized location.Use cases
Finding where a story is loudest
Finding where a story is loudest
Group analytics by country or state to see which markets are driving a spike, then drill to city level to find the specific concentration.
Regional crisis scoping
Regional crisis scoping
Filter a workspace to a region before pulling narratives and top accounts, so a briefing reflects the market that’s actually affected rather than global volume.
Market comparison
Market comparison
Break the same narrative down across countries to see whether framing differs by market, useful for global brands running region-specific messaging.
Domestic versus international coverage
Domestic versus international coverage
Separate home-market coverage from international pickup to understand whether a story has crossed borders.
Geographic concentration as an authenticity signal
Geographic concentration as an authenticity signal
Coverage that resolves to an unexpectedly narrow set of locations can be worth a closer look, though given the coverage caveats above, treat this as a prompt to investigate rather than a finding.
FAQs
Can I get state-level data outside the US?
Can I get state-level data outside the US?
Not currently. State and county are US-only at launch; other countries resolve to country and, where possible, city.
Does filtering on a country include its cities?
Does filtering on a country include its cities?
Yes. Selecting any level automatically includes everything beneath it.
Related reading
API Changelog
Full technical detail on the location fields.
API Introduction
Getting started with the PeakMetrics API.
MCP Server
Querying your workspace conversationally, including by place.
Exporting Data
Taking workspace data into your own analysis.