Rate Limits

Usage of the API is subject to rate limits. The limits are based on a moving window that tracks the number of requests you send per hour.

Overview

An application can make up to 5,000 userless requests per hour to venues/* endpoints.

An application can make up to 500 userless requests to most other endpoints groups per hour.

An application can make up to 500 authenticated requests requests per hour per OAuth token. For example, if your app has 3 connected users, it could make at most 500 requests on behalf of the each connected user, for a maximum of 1,500 authenticated requests per hour.

Please note that rate limits are not per endpoint, but per top-level endpoint group. For example, in an hour, if you make 2,500 userless requests to venues/search and 2,500 userless requests to venues/explore, you would have exhausted your venues/* rate limits for that hour; however, you would still have 500 requests left for tips/*.

Generally rate limits follow the rules above; however, some endpoints may have different limits due to security or other considerations. For the most current and accurate rate limit usage information for a particular request type, inspect the X-RateLimit-Remaining and X-RateLimit-Limit HTTP headers of API responses.

If you are currently over limits, our API will return a 403 error, and the response object returned by our API will be empty. We will also include a X-RateLimit-Reset header in the response, which is a timestamp that corresponds to when your rate limits will reset.

Increases

Userless rate limits can be increased by request; however, we highly encourage you to first consider offering Foursquare authentication in your application as a way to automatically and naturally have much more favorable rate limits. In addition to the 500 requests/hour you can make on each user's behalf, you'll also receive higher precision, personalized results for many requests, such as search and explore.

If you still decide that your application needs more userless requests per hour, please fill out our rate limit increase request form. We will evaluate your request and reach back out to you with more details on how to proceed next.