API Usage

🛠️

Public Beta Feature

This documentation covers a feature currently in Public Beta. Access is available to anyone interested in building personalized experiences for their end-users.

This feature is subject to the Personalization API (Self-Service) Public Beta End user License Agreement 📄.

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.

Authentication

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

Versioning

Adapt to Foursquare API changes on your own schedule.

Rate Limits

Usage of the Personalization API is subject to rate limits.

Errors

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

Localization

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

Harmonization

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.