Integration guide

This page contains information on several tools and key concepts that you should be aware of as you integrate the Likes endpoints into your system. We’ve broken the page into a couple of different sections:


Helpful tools

Before we dive into some key concepts that will help you integrate this endpoint, we recommend that you become familiar with:


Postman is a great tool that you can use to test out an endpoint. Each Postman request includes every path and body parameter to help you quickly understand what is available to you. To learn more about our Postman collections, please visit our "Using Postman" page. 

Code samples

Interested in getting set up with this endpoint with some code in your preferred coding language? We’ve got a handful of different code samples available that you can use as a starting point on our Github page.

Third-party libraries

Take advantage of one of our communities’ third-party libraries to help you get started. You can find a library that works with the v2 endpoints by looking for the proper version tag.

Key concepts


All Twitter API v2 endpoints require for you to authenticate your requests with a set of credentials, also known as keys and tokens.

You can use either OAuth 1.0a User Context or OAuth 2.0 Bearer Token to authenticate your requests to the Likes lookup endpoints

The POST and DELETE endpoints specific endpoint requires the use of OAuth 1.0a User Context, which means that you must use a set of API keys and user access tokens to make a successful request. The access tokens must be associated with the user that you are making the request on behalf of. If you would like to generate a set of access tokens for another user, they must authorize or authenticate your App using the 3-legged OAuth flow.

Please note that OAuth 1.0a can be tricky to use. If you are not familiar with this authentication method, we recommend that you use a library or a tool like Postman to properly authenticate your requests.

Please note

If you are requesting the following fields, OAuth 1.0a User Context is required: 

  • tweet.fields.non_public_metrics
  • tweet.fields.promoted_metrics
  • tweet.fields.organic_metrics
  • media.fields.non_public_metrics
  • media.fields.promoted_metrics
  • media.fields.organic_metrics

Developer portal, Projects, and developer Apps

To retrieve a set of authentication credentials that will work with the Twitter API v2 endpoints, you must have an approved developer account, set up a Project within that account, and created a developer App within that Project. You can then find your keys and tokens within your developer App. 

Rate limits

Every day, many thousands of developers make requests to the Twitter API. To help manage the sheer volume of these requests, rate limits are placed on each endpoint that limits the number of requests that you can make on behalf of your app or on behalf of an authenticated user. 

This endpoint is rate limited at the user-level, meaning that the authenticated user that you are making the request on behalf of can only perform 75 requests per 15 min.

For the v2 liking users endpoint, you are limited to 100 liking users per tweet for all time. With the v2 liked Tweets endpoint you request up to 800 tweets per request.

Fields and expansions

The Twitter API v2 allows users to select exactly which data they want to return from the API using a set of tools called fields and expansions. The expansion parameter allows you to expand objects referenced in the payload. For example, this endpoint allows you to pull the following expansions:

  • attachments.poll_ids
  • attachments.media_keys
  • author_id, entities.mentions.username
  • geo.place_id
  • in_reply_to_user_id,

The fields parameter allows you to select exactly which fields within the different data objects you would like to receive. These endpoints delivers Tweet objects primarily. By default, the Tweet object returns the id and text fields. To receive additional fields such as tweet.created_at or tweet.entities, you will have to specifically request those using a fields parameter. Some important fields that you may want to consider using in your integration are our poll data, metrics, Tweet annotations, and conversation ID fields.

We’ve added a guide on how to use fields and expansions together to our Twitter API v2 data dictionary.



The liked Tweets endpoint can return a lot of data. To ensure we don’t return too many results at any given time, we use pagination. Learn more about how to paginate through results.

Note: The liking users endpoint does not support pagination. 

Was this document helpful?
Thank you

Thank you for the feedback. We’re really glad we could help!

Thank you for the feedback. How could we improve this document?
Thank you for the feedback. Your comments will help us improve our documents in the future.