ZIP Code Capture
The ZIP Code Capture dataset provides a geographic distribution of shopper origin for each Business Location over a defined reporting period. For each location, it identifies which ZIP codes customers are traveling from and the share of transactions attributed to each origin ZIP code.
This dataset is particularly useful for trade area definition, event catchment analysis, and understanding the geographic reach of a business location.
Schema
business_location_id
String
No
UUID of the associated Business Location
001dd142-4627-4bcf-be8a-b048e...
start_at
Date
No
Start date of the reporting period (inclusive)
2024-03-01
end_at
Date
No
End date of the reporting period (inclusive)
2024-03-31
zip_code
String
No
Origin ZIP code of shoppers
90210
capture_percent
Float
No
Share of the location's total transactions originating from this ZIP code, expressed as a decimal (e.g. 0.032 = 3.2%)
0.032
Notes
capture_percent sums to ~1.0 per location per period. Summing all capture_percent values for a given business_location_id, start_at, and end_at combination should approximately equal 1.0. Minor discrepancies may occur due to rounding or unresolved ZIP codes.
Reporting period — Data is typically delivered at monthly granularity, where start_at is the first day of the month and end_at is the last day.
Last updated