Comparing X API’s follows endpoints
Follows lookup
The v2 follows lookup endpoints will replace the standard v1.1 followers/ids, v1.1 followers/list, v1.1 friends/ids, and v1.1 friends/list endpoints.
The following tables compare the various types of follows lookup 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/friends/ids.json /1.1/friends/list.json /1.1/followers/ids.json /1.1/followers/list.json |
/2/users/:id/following /2/users/:id/followers |
OAuth 1.0a User Context App only |
OAuth 1.0a User Context OAuth 2.0 Authorization Code with PKCE App only |
|
Default request rate limits |
15 requests per 15 min (per user) 15 requests per 15 min (per app) |
15 requests per 15 min (per user) 15 requests per 15 min (per app) |
Maximum users per response |
GET friends/id & GET followers/id return a maximum of 5000 users IDs per page. GET friends/list & GET followers/list return a maximum of 200 user objects per page. |
1000 user objects per page |
Pagination |
Token returns in a next_cursor field, which can then be passed as the value to the cursor parameter to return the next page of results. |
Token returns in a next_token field, which can then be passed as the value to the token parameter to return the next page of results. The v2 payload also delivers a previous_token field, which can also be passed with the pagination_token parameter to return the previous page of results. |
JSON format |
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. |
Supports selecting which fields return in the payload |
✔ |
|
| Supports the Post annotations fields | ✔ | |
| Supports requesting new metrics fields | ✔ | |
| Supports the conversation_id field | ✔ | |
| Requires the use of credentials from a developer App associated with a project | ✔ |
Manage follows
The v2 manage follows endpoints will replace the standard v1.1 POST friendships/create and POST friendships/destroy endpoints.
The following tables compare the standard v1.1 and X API v2 create follow endpoints:
Follow a user
| 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/friendships/create.json | /2/users/:id/following |
| Authentication | OAuth 1.0a User Context | OAuth 1.0a User Context OAuth 2.0 Authorization Code with PKCE |
| Default request rate limits | 50 requests per 15 min | 50 requests per 15 min |
| Maximum daily operations per users | 400 | 400 |
| Maximum daily operations per app | 1000 | 1000 |
| Requires use of credentials from a developer App that is associated with a Project | ✔️ |
Unfollow a user
The following tables compare the standard v1.1 and X API v2 delete follow endpoints:
| 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/friendships/destroy.json | /2/users/:source_user_id/following/:target_user_id |
| Authentication | OAuth 1.0a User Context | OAuth 1.0a User Context OAuth 2.0 Authorization Code with PKCE |
| Default request rate limits | 15 requests per 15 min (per user) | 50 requests per 15 min (per user) |
| Maximum daily operations per app | None | 500 |
| Requires use of credentials from a developer App that is associated with a Project | ✔️ |