Description

Get venue stats over a given time range. Only available to the manager of a venue.


Request

GET https://api.foursquare.com/v2/venues/VENUE_ID/stats


Authentication

User authentication. Must be a venue manager.


Parameters

Name Type Description
VENUE_ID AVNU234 required The venue id to retrieve stats for.
startAt 1284286794 The start of the time range to retrieve stats for (seconds since epoch). If omitted, all-time stats will be returned.
endAt 1284286794 The end of the time range to retrieve stats for (seconds since epoch). If omitted, the current time is assumed.

Response Fields

Field Description
totalCheckins Number of total checkins at the venue during the time period.
newCheckins Number of new visitors to the venue during the time period.
uniqueVisitors Number of unique visitors at the venue during the time period.
sharing A subobject containing fields twitter and facebook indicating the number of check-ins at the venue pushed to twitter and facebook.
genderBreakdown A subobject containing fields female and male indicating the number of checkins at the venue by men and women.
ageBreakdown An array of subobjects with fields age and checkins indicating the number of check-ins at the venue by people of different age ranges.
hourBreakdown A 24-element array of subobjects with fields hour and checkins indicating the number of checkins at the venue during each hour of the day.
visitCountHistogram A list of subobjects with fields checkins and users indicating how many users checked in a given number of times.
topVisitors An array of the top 10 users by check-in count during the time period. Array elements are objects with fields user, and checkins, the number of checkins by that user. Does not include users who have opted out of sharing their check-ins with venue managers in their settings.
recentVisitors An array of the 10 most recent users. Array elements are objects with fields user and lastCheckin, the timestamp of the user’s last check-in. This field is only present if startAt is specified and endAt is NOT specified (i.e., now). Does not include users who have opted out of sharing their check-ins with venue managers in their settings.