POST favorites/create
post-favorites-create

POST favorites/create

Note: favorites are now known as likes.

Favorites (likes) the Tweet specified in the ID parameter as the authenticating user. Returns the favorite Tweet when successful.

The process invoked by this method is asynchronous. The immediately returned Tweet object may not indicate the resultant favorited status of the Tweet. A 200 OK response from this method will indicate whether the intended action was successful or not.

Resource URL

https://api.x.com/1.1/favorites/create.json

Resource Information

Response formats JSON
Requires authentication? Yes (user context only)
Rate limited? Yes
Requests / 24-hour window 1000 per user; 1000 per app

Parameters

Name Required Description Default Value Example
id required The numerical ID of the Tweet to like. 123
include_entities optional The entities node will be omitted when set to false . false

Example Request

curl --request POST 
--url 'https://api.x.com/1.1/favorites/create.json?id=TWEET_ID_TO_FAVORITE' 
--header 'authorization: OAuth oauth_consumer_key="YOUR_CONSUMER_KEY", oauth_nonce="AUTO_GENERATED_NONCE", oauth_signature="AUTO_GENERATED_SIGNATURE", oauth_signature_method="HMAC-SHA1", oauth_timestamp="AUTO_GENERATED_TIMESTAMP", oauth_token="USERS_ACCESS_TOKEN", oauth_version="1.0"' 
--header 'content-type: application/json'

Example Response

{tweet-object,
"user": {user-object}
}