Skip to content

GeoMeters Data Dictionary

Fresh

GeoMeters are region-specific popularity rankings that reflect user interest in titles and people within specific geographic markets. They follow the same structure as the global Meters datasets but are scoped to individual countries or regional groupings.


Datasets

DatasetScopeSize per Region
geo_title_meter_v1All title typesTop 1,000 per region
geo_tv_meter_v1TV shows onlyTop 1,000 per region
geo_movie_meter_v1Movies onlyTop 1,000 per region
geo_star_meter_v1Names (people)Top 1,000 per region

Each dataset contains multiple records per day — one record per rank position per region.


Record Structure

All four geo meter datasets share the same field structure:

FieldTypeDescription
rankintegerRank within this region (1 = most popular)
titleId or nameIdstringIMDb ID of the entity
areastringRegion or country code
datestringDate of this ranking snapshot (YYYY-MM-DD)

geo_title_meter_v1 Example

json
{ "rank": 1, "titleId": "tt15398776", "area": "US", "date": "2026-05-08" }
{ "rank": 2, "titleId": "tt0903747", "area": "US", "date": "2026-05-08" }
{ "rank": 1, "titleId": "tt0468569", "area": "IN", "date": "2026-05-08" }
{ "rank": 2, "titleId": "tt1877830", "area": "IN", "date": "2026-05-08" }

geo_star_meter_v1 Example

json
{ "rank": 1, "nameId": "nm0425005", "area": "US", "date": "2026-05-08" }
{ "rank": 2, "nameId": "nm1165110", "area": "US", "date": "2026-05-08" }
{ "rank": 1, "nameId": "nm2225369", "area": "IN", "date": "2026-05-08" }

Available Areas

Regional Groupings

CodeRegion
APACAsia-Pacific
EMEAEurope, Middle East, and Africa
NANorth America
LATAMLatin America

Individual Countries

CodeCountryCodeCountry
AUAustraliaJPJapan
BRBrazilKRSouth Korea
CACanadaMXMexico
DEGermanyUSUnited States
ESSpainGBUnited Kingdom
FRFranceINIndia
ITItaly

Querying in Athena

GeoMeter data is well-suited for Athena queries. The area column allows you to filter or group by region directly in SQL.

Example — top 10 titles in the United States today:

sql
SELECT rank, titleId, date
FROM geo_title_meter_v1
WHERE area = 'US'
  AND date = '2026-05-08'
ORDER BY rank ASC
LIMIT 10;

Example — compare top title across regions:

sql
SELECT area, titleId, rank
FROM geo_title_meter_v1
WHERE rank = 1
  AND date = '2026-05-08'
ORDER BY area;

See the full Querying in Athena page for DDL table definitions and more complex query patterns.

IMDb API Documentation — Internal Reference