Comparing Twitter API’s blocks endpoints
Blocks lookup
The v2 blocks lookup endpoint will replace the standard v1.1 GET blocks/list and GET blocks/ids endpoints.
The following tables compare the standard v1.1 and Twitter API v2 block endpoints:
| Description | Standard v1.1 | Twitter API v2 |
|---|---|---|
| HTTP methods supported | GET | GET |
| Host domain | https://api.twitter.com | https://api.twitter.com |
| Endpoint path | /1.1/blocks/ids.json /1.1/blocks/list.json |
/2/users/:id/blocking |
| Authentication | OAuth 1.0a User Context | OAuth 1.0a User Context |
| Default request rate limits | 15 requests per 15 min (per user) | 15 requests per 15 min (per user) |
| Data formats | Standard v1.1 format | Twitter 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 Twitter API v2 format, please visit our data formats migration guide. |
| Requires use of credentials from a developer App that is associated with a Project | ✔️ |
Manage blocks
The v2 manage blocks endpoints will replace the standard v1.1 POST blocks/create and POST blocks/destroy endpoints.
The following tables compare the standard v1.1 and Twitter API v2 block endpoints:
Block a user
| Description | Standard v1.1 | Twitter API v2 |
|---|---|---|
| HTTP methods supported | POST | POST |
| Host domain | https://api.twitter.com | https://api.twitter.com |
| Endpoint path | /1.1/blocks/create.json | /2/users/:id/blocking |
| Authentication | OAuth 1.0a User Context | OAuth 1.0a User Context |
| Default request rate limits | None | 50 requests per 15 min (per user) |
| Requires use of credentials from a developer App that is associated with a Project | ✔️ |
Unblock a user
The following tables compare the standard v1.1 and Twitter API v2 unblock endpoints:
| Description | Standard v1.1 | Twitter API v2 |
|---|---|---|
| HTTP methods supported | POST | DELETE |
| Host domain | https://api.twitter.com | https://api.twitter.com |
| Endpoint path | /1.1/blocks/destroy.json | /2/users/:source_user_id/blocking/:target_user_id |
| Authentication | OAuth 1.0a User Context | OAuth 1.0a User Context |
| Default request rate limits | None | 50 requests per 15 min (per user) |
| Requires use of credentials from a developer App that is associated with a Project | ✔️ |