Primary category
primaryCategory
Optional
First category Google assigns, e.g. 'Gym'.
Google Maps Popular Times & Traffic Analytics
Pricing
from $0.30 / 1,000 results
Collect Google Maps Popular Times foot-traffic curves in bulk: hour-by-hour busyness for every day of the week, plus live occupancy where available, for whole categories of venue in an area (every gym or cafe in a city). Wide or long format, JSON/CSV/Excel/NDJSON. No API key.
Input
_input
Optional
The query or identifier that produced this record.
Source strategy
_source
Optional
S1-preview-place, or none on failure rows.
Scraped at
_scrapedAt
Optional
UTC ISO 8601 timestamp when this record was emitted.
Record type
recordType
Optional
PLACE (wide format), POPULAR_TIMES_HOUR (long format), or ERROR.
Error
_error
Optional
Failure rows only: search_failed, unresolvable_input or detail_failed.
Error detail
_errorDetail
Optional
Free-form diagnostic accompanying _error.
Venue name
name
Optional
Business name as shown on Google Maps.
Primary category
primaryCategory
Optional
First category Google assigns, e.g. 'Gym'.
Categories
categories
Optional
All categories Google assigns.
Address
address
Optional
Single-line formatted address.
Latitude
latitude
Optional
Real GPS latitude of the venue.
Longitude
longitude
Optional
Real GPS longitude of the venue.
Timezone
timezone
Optional
IANA timezone -- needed to interpret the hourly curve locally.
Place ID
placeId
Optional
Google Place ID (ChIJ...).
Feature ID
featureId
Optional
Google internal feature id, 0x...:0x...
Google Maps URL
googleMapsUrl
Optional
Canonical Maps link for the venue.
Rating
rating
Optional
Average star rating.
Reviews count
reviewsCount
Optional
Total Google reviews -- a rough proxy for venue size.
Opening hours
openingHours
Optional
Weekly schedule, where Google supplied it.
Has popular times
hasPopularTimes
Optional
Whether Google returned a foot-traffic curve for this venue.
Popular times
popularTimes
Optional
Wide format: seven day objects, each with dayNumber (1=Monday), hasData, peakHour, peakOccupancyPercent and an hours list of {hour, occupancyPercent, label, displayHour}.
Days with data
daysWithData
Optional
How many of the seven days carry a curve.
Busiest day
busiestDay
Optional
Day containing the highest occupancy reading.
Busiest hour
busiestHour
Optional
Hour (0-23) of the weekly peak.
Peak occupancy %
peakOccupancyPercent
Optional
Highest occupancy reading across the week, 0-100.
Average occupancy %
averageOccupancyPercent
Optional
Mean occupancy across every hour Google reports.
Has live data
hasLiveData
Optional
True only for a real live measurement. A 'Now: ...' status line is a projection from the weekly curve and does not count.
Live occupancy %
liveOccupancyPercent
Optional
Current occupancy 0-100, when Google has a live reading.
Live hour
liveHour
Optional
Hour (0-23) the live reading refers to.
Live status text
liveStatusText
Optional
Google's wording, e.g. 'Less busy than usual' or 'Now: Usually as busy as it gets'.
Current day
currentDay
Optional
Day number (1=Monday) at scrape time, per the venue's own timezone.
Current hour
currentHour
Optional
Hour (0-23) at scrape time, per the venue's own timezone.
Day
day
Optional
Long format: day name for this row.
Day number
dayNumber
Optional
Long format: 1=Monday .. 7=Sunday.
Hour
hour
Optional
Long format: hour of day, 0-23.
Display hour
displayHour
Optional
Long format: Google's own label for the hour, e.g. '6 am'.
Occupancy %
occupancyPercent
Optional
Long format: busyness for this venue/day/hour, 0-100.
Busyness label
label
Optional
Long format: e.g. 'Usually a little busy'. Empty when the venue is closed that hour.
Is peak hour
isPeakHour
Optional
Long format: whether this hour is that day's peak.