### 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](https://location.foursquare.com/legal/terms/personalization-apis-self-service-eula/) 📄.

## Overview  
Foursquare rate limits any application making authenticated requests on a per hour per OAuth token basis. Please refer to the [Rate Limit Per Endpoint Resource table](https://docs.foursquare.com/developer/reference/personalization-apis-rate-limits#rate-limit-per-endpoint-resource) below.

As an example, if your application has 3 connected users, it could make at most **500** requests on behalf of each connected user, for a total of **1,500** authenticated requests per hour.

Please note that rate limits are, in general, not per endpoint, but per top-level endpoint resource or group. For example, if you make **250** requests to `venues/search` and **250** 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. Please refer to the [Rate Limit Exceptions table](https://docs.foursquare.com/developer/reference/personalization-apis-rate-limits#rate-limit-exceptions) below.

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.

## Rate Limit Per Endpoint Resource  
The following table includes the rate limits per [managed user OAuth token](https://docs.foursquare.com/developer/reference/personalization-apis-authentication#foursquare-managed-user-auth-flow).

| Endpoint Resource | Rate Limit (per OAuth Token) |
| --- | --- |
| Checkins | 500 |
| Lists | 1000 |
| Photos | 500 |
| Search | 500 |
| Tips | 500 |
| Users | 500 |
| Venues | 500 |

The following table includes the rate limits per [Developer Service API Key](https://docs.foursquare.com/developer/reference/personalization-apis-authentication#service-api-keys).

| Endpoint Resource | Rate Limit (per Service Key) |
| --- | --- |
| User Management | 3600 |

## Rate Limit Exceptions  
The following table includes rate limit exceptions for specific endpoints.

| Endpoint | Rate Limit (per OAuth Token) |
| --- | --- |
| Search Autocomplete | 2000 |
| POST Endpoints | 500 |