Comparing X API’s Likes endpoints
These guides will focus on the following areas:
- API request parameters - The X API v2 endpoint introduces a new set of request parameters. While some parameters will be familiar, especially for those integrating with Labs, there are many important differences such as the introduction of the fields and expansions parameters.
- App and Project requirements - To access the X API v2, you will need to use credentials from a developer App that is associated with a Project
Likes lookup
Users who have liked a Post
The liked users endpoint is new functionality for v2, allowing you to get information about a Post's liking users.
| Description | X API v2 |
|---|---|
| HTTP methods supported | GET |
| Host domain | https://api.x.com |
| Endpoint path | /2/tweets/:id/liking_users |
| Authentication | OAuth 2.0 Bearer Token OAuth 1.0a User Context |
| Default request rate limits | 75 requests per 15 min (per App) 75 requests per 15 min (per user) |
Posts liked by a user
The following tables compare the standard v1.1 GET favorites/list endpoint and the X API v2 liked Posts endpoints:
| Description | Standard v1.1 | X API v2 |
|---|---|---|
| HTTP methods supported | GET | GET |
| Host domain | https://api.x.com | https://api.x.com |
| Endpoint path | /1.1/favorites/list.json | /2/users/:id/liked_tweets |
| Authentication | OAuth 1.0a User Context | OAuth 2.0 Bearer Token OAuth 1.0a User Context |
| Default request rate limits | 75 requests per 15 min |
75 requests per 15 min (per App) 75 requests per 15 min (per user) |
| Data formats | Standard v1.1 format | X API v2 format (determined by fields and expansions request parameters, not backward-compatible with v1.1 formats) To learn more about how to migrate from the Standard v1.1 format to the X API v2 format, please visit our data formats migration guide. |
Manage Likes
The v2 manage Likes endpoints replace the v1.1 POST favorites/create and POST favorites/destroy endpoints.
The following tables compare the standard v1.1 and X API v2 manage Like endpoints:
Like a Post
| Description | Standard v1.1 | X API v2 |
|---|---|---|
| HTTP methods supported | POST | POST |
| Host domain | https://api.x.com | https://api.x.com |
| Endpoint path | /1.1/favorites/create.json | /2/users/:id/likes |
| Authentication | OAuth 1.0a User Context | OAuth 1.0a User Context |
| Default request rate limits | 1000 requests per 24 hours (per user) 1000 requests per 24 hours (per App) |
50 requests per 15 min (per user) 1000 requests per 24 hours (per user, shared with DELETE) |
Unlike a Post
| Description | Standard v1.1 | X API v2 |
|---|---|---|
| HTTP methods supported | POST | DELETE |
| Host domain | https://api.x.com | https://api.x.com |
| Endpoint path | /1.1/favorites/destroy.json | /2/users/:id/likes/:tweet_id |
| Authentication | OAuth 1.0a User Context | OAuth 1.0a User Context |
| Default request rate limits | 1000 requests per 24 hours (per user) 1000 requests per 24 hours (per App) |
50 requests per 15 min (per user) 1000 requests per 24 hours (per user, shared with POST) |