Rate Limits

Usage of the API is subject to an hourly rate limit and a daily call quota, whichever occurs first.

The rate limits are based on a moving window that tracks the number of requests you make per hour.

The call quota is the maximum number of API calls that can be made in a 24 hour period resetting each day at midnight UTC.

Note to Existing Developers

If you began using the Foursquare API prior to June 20, 2017, we have rolled out an additional verification step to ensure that we can continue to deliver the best-possible location service to our developer community. By verifying your account, we will be able to confirm your identity and learn more about how you are using the Foursquare API, so we can better optimize our platform.

  • If you verify your account, you will be able to make 100,000 calls per day for one primary app. All other apps will be able to make 1,000 calls per day.
  • Before verifying your account, you will not be subject to daily call quotas (however, the current hourly rate limit still applies).
  • On August 22, 2017, if you have not verified your account, all of your existing apps will be subject to a call quota of 1,000 calls per day. You will still be able to verify your account at any time to receive 100,000 calls per day for one primary app.

Please verify your account before August 22, 2017 to ensure your app continues to run smoothly.

Daily Call Quota Overview

The Foursquare API has a default limit of 1,000 free requests per 24 hour period for unverified accounts across all endpoints.

You may verify your account using a credit card to increase this limit to 100,000 requests per 24 hour. This can be done from the New Developer App page when creating your first app or the My Apps page if you have already created an app.

If you require more than 100,000 calls per day, please contact us rather than create multiple Foursquare accounts.

The daily call quota resets each day at midnight UTC. If you are over the daily call quota limit, the Foursquare API will return a 429 error until the time of reset.

Rate Limit 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

Hourly 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 decide that your application needs more requests per hour or more requests per day, please contact us.

For additional Enterprise based offerings please see enterprise.foursquare.com.