Daily Venue Stats over time

Description

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

Note: User must be a venue manager.

Request

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

Authentication

This endpoint requires user authentication.

Supported Description
User required A valid OAuth access token in the query string of each request. Eg. &oauth_token=XXXX

For more information about this authentication method and how to obtain an access token, see the Authentication docs.

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+.