Today, we are excited to announce the launch of Likes and blocks lookup endpoints. This release brings the Twitter API v2 a little bit closer to achieving v1.1 parity and delivers net new Likes functionality, only available on v2.
Likes lookup
Liking Tweets is one of the core features people use to engage in the public conversation on Twitter. With endpoints in our Likes lookup endpoint group, you can see a list of accounts that have liked a specified Tweet, or which Tweets a specified account has liked. You could use these endpoints to understand what kind of content a specified account or group of accounts Likes, or study how information spreads across Twitter.
There are two endpoints available:
- Tweets liked by a user - GET /2/users/:id/liked_tweets
- Users who have liked a Tweet - GET /2/tweets/:id/liking_users
You can authenticate these endpoints with either OAuth 1.0a User Context or OAuth 2.0 Bearer Token. For the users who have liked a Tweet endpoint, pagination tokens will be provided for paging through large sets of results.
The liking users endpoint limits you to a total of 100 liking accounts per tweet for all time. Additionally, the liked Tweets endpoint is also subject to the monthly Tweet cap applied at the Project level.
Blocks lookup
Blocking users is a core security feature on Twitter. Using blocks lookup, you can see who you or an authenticated user has blocked. This can be useful for determining how you interact with a given account.
There is one endpoint available:
- Accounts blocked by an authenticated user - GET /2/users/:id/blocking
Since you are making requests for private information with blocks lookup, and on behalf of a user with manage blocks, you must authenticate to this endpoint with OAuth 1.0a User Context and use the Access Tokens associated with a user that has authorized your App, which can be generated using the 3-legged OAuth flow.
This endpoint has a rate limit of 15 requests per 15 minutes per user.
Getting started
Developers with access to the Standard product track or the new Academic Research product track can begin using these endpoints right away. For now, these endpoints are only available at our Basic access level. Be sure to check out our documentation for more information on how to get started.
We’re continuing to add new features and functionality to Twitter API v2. Be sure to keep an eye on our public roadmap for the latest. As always, we’d love to hear what you think. Please reach out with any questions or feedback on what you’d like to see in the future.