API Usage


Private Beta Feature

This documentation covers a feature currently in Private Beta. Access is exclusive to approved participants. If you're interested in joining the Private Beta program, apply here.

Please note that while the docs are publicly viewable, functionality is limited to Private Beta participants until public launch.

The Foursquare Personalization API offers real-time access to Foursquare’s global database of rich venue data and user content to power your location-based experiences in your app or website.


Authenticating against the API is done by passing your API Key.


Adapt to Foursquare API changes on your own schedule.

Rate Limits

Usage of the Personalization API is subject to rate limits.


HTTP status codes to indicate success or failure of an API request.


Specify the locale by setting the Accept-Language HTTP header in your request.


The process of venue harmonization on Foursquare is fairly simple!

POI Categories

Accurate and granular categorization to each of our POI records.

POI Chains

Explicit associations between national and local brands and their brick-and-mortar locations.

Usage Guidelines

Help us maintain our platform, and follow our Usage rules.

Real Time View

Allow your application to get a real-time view into various actions on Foursquare.