Description

Get daily venue stats for a list of venues over a time range.


Request

GET https://api.foursquare.com/v2/venues/timeseries


Authentication

User must be venue manager.


Parmeters

Name Type Description
venueId AVNU234,AVNU567 A comma-separated list of venue ids to retrieve series data for. The current user must be the manager of all venues specified.
startAt 1284286794 required. The start of the time range to retrieve stats for (seconds since epoch).
endAt 1284286794 The end of the time range to retrieve stats for (seconds since epoch). If omitted, the current time is assumed.
fields totalCheckins,newCheckins Specifies which fields to return. May be one or more of totalCheckins, newCheckins, uniqueVisitors, sharing, genders, ages, hours, separated by commas.

Response Fields

Field Description
venueId The venue id
date An array of dates in the format yyyymmdd.
totalCheckins An array of total check-in counts, one item for each day in the given range (inclusive).
newCheckins An array of counts of new users visiting the venue, one item for each day in the given range (inclusive).
shareTwitter An array of counts of check-ins shared to Twitter.
shareFacebook An array of counts of check-ins shared to Facebook.
male An array of counts of check-ins where the user has specified their gender as male.
female An array of counts of check-ins where the user has specified their gender as female.
ageXX-XX An array of counts of check-ins where the user has specified their age in the given range. The provided ranges are 13-17, 18-24, 25-34, 35-44, 45-54, and 55+.