---
title: "Get User's Twitter Likes - API Reference"
description: "Retrieve every tweet a Twitter/X user has liked. Flat-rate $0.0002 per tweet, flexible rate limits and no subscription plans."
source: "https://docs.socialdata.tools/reference/get-user-likes/"
---
> **Deprecated**
>
> Due to Twitter’s decision to make likes private for all users, this endpoint is unable to provide any data.
Returns an array of tweets from the user’s likes timeline. Typically Twitter returns ~20 results per page. You can request additional results by sending another request to the same endpoint using the `cursor` parameter.
GET https://api.socialdata.tools/twitter/user/{user\_id}/likes?cursor={cursor}
## Headers
**Authorization** `string` — required
Authorization Bearer header containing your SocialData API key
Example: Bearer YOUR\_API\_KEY
## Path Parameters
**user\_id** `integer` — required
The numeric ID of the desired user.
Example: 1729591119699124560
## Query Parameters
**cursor** `string` — optional
Cursor value obtained from the next\_cursor response property. Omit this value to retrieve the first page. Always remember to urlencode the value.
Example: DAACCgACGC12FhmAJxAKAAMYLXYWGX\_Y8AgABAAAAAILAAUAAADoRW1QQzZ3QUFBZlEvZ0d...
> **Caution**
>
> When using languages where the `user_id` value exceeds the default Integer type limit (e.g., JavaScript), you should store `user_id` as a String. Use the `id_str` property returned by the API for these values
## Code Examples
#### curl
```shellscript
curl "https://api.socialdata.tools/twitter/user/44196397/likes" \
-H 'Authorization: Bearer API_KEY' \
-H 'Accept: application/json'
```
#### JavaScript
```js
const userId = '44196397';
const API_KEY = 'YOUR_API_KEY_HERE';
fetch(`https://api.socialdata.tools/twitter/user/${userId}/likes`, {
method: 'GET',
headers: {
'Authorization': `Bearer ${API_KEY}`,
'Accept': 'application/json'
}
})
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
```
#### Python
```python
import requests
userId = '44196397'
API_KEY = 'YOUR_API_KEY_HERE'
url = f'https://api.socialdata.tools/twitter/user/{userId}/likes'
headers = {
'Authorization': f'Bearer {API_KEY}',
'Accept': 'application/json'
}
response = requests.get(url, headers=headers)
if response.status_code == 200:
data = response.json()
print(data)
else:
print(f"Error: {response.status_code}")
print(response.text)
```
#### PHP
```php
$userId = '44196397';
$API_KEY = 'YOUR_API_KEY_HERE';
$url = "https://api.socialdata.tools/twitter/user/{$userId}/likes";
$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => $url,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer $API_KEY",
"Accept: application/json"
]
]);
$response = curl_exec($ch);
$data = json_decode($response, true);
print_r($data);
curl_close($ch);
```
## Example Responses
#### 200
```json
{
"next_cursor": "DAACCgACGC12FhmAJxAKAAMYLXYWGX_Y8AgABAAAAAILAAUAAADoRW1QQzZ3QUFBZlEvZ0dKTjB2R3AvQUFBQUJNWUxTNkQyQmFoUXhndFRReS9Ga0NOR0MwZG9yS1hzU2NZTFFwYm0xY1I0aGd0YmhZc1drQ3FHQzBjUXNSV1lSZ1lMVml5V3BxQU9CZ3RMbUhUV2tDb0dDMVFuVW1YMEFzWUxKYURhOVpob3hndFZtaklGakNNR0MxWGdlT1dZSE1ZTFRYNFNwZUEraGd0Y2h2bEYxRkxHQzFNMi83V1VGc1lMTTZwemhZQWt4Z3RWMkJKbDNGN0dDMWFGTXBYUUY4WUxUUERuRlp3UVE9PQgABgAAAAAIAAcAAAAADAAICgABGCyWg2vWYaMAAAA",
"tweets": [
{
"tweet_created_at": "2023-12-13T05:39:09.000000Z",
"id_str": "1734810168053956719",
"text": null,
"full_text": "@TeslaHype Pace of Progress",
"source": "Twitter for iPhone<\\/a>",
"truncated": false,
"in_reply_to_status_id_str": "1734777084268920960",
"in_reply_to_user_id_str": "1311506622821400581",
"in_reply_to_screen_name": "TeslaHype",
"user": {
"id_str": "44196397",
"name": "Elon Musk",
"screen_name": "elonmusk",
"location": "\\ud835\\udd4f\\u00d0",
"url": null,
"description": "",
"protected": false,
"verified": false,
"followers_count": 166213349,
"friends_count": 506,
"listed_count": 149586,
"favourites_count": 37958,
"statuses_count": 34934,
"created_at": "2009-06-02T20:12:29.000000Z",
"profile_banner_url": "https:\\/\\/pbs.twimg.com\\/profile_banners\\/44196397\\/1690621312",
"profile_image_url_https": "https:\\/\\/pbs.twimg.com\\/profile_images\\/1683325380441128960\\/yRsRRjGO_normal.jpg",
"can_dm": false
},
"quoted_status_id_str": null,
"is_quote_status": false,
"quoted_status": null,
"retweeted_status": null,
"quote_count": 11,
"reply_count": 156,
"retweet_count": 78,
"favorite_count": 977,
"lang": "en",
"entities": {
"user_mentions": [
{
"id_str": "1311506622821400581",
"name": "Tesla Hype",
"screen_name": "TeslaHype",
"indices": [
0,
10
]
}
],
"urls": [],
"hashtags": [],
"symbols": []
},
"views_count": 32377,
"bookmark_count": 19
},
{
"tweet_created_at": "2023-12-13T05:38:26.000000Z",
"id_str": "1734809984674693446",
"text": null,
"full_text": "@anammostarac Yeah",
"source": "Twitter for iPhone<\\/a>",
"truncated": false,
"in_reply_to_status_id_str": "1734809562258276654",
"in_reply_to_user_id_str": "2852570664",
"in_reply_to_screen_name": "anammostarac",
"user": {
"id_str": "44196397",
"name": "Elon Musk",
"screen_name": "elonmusk",
"location": "\\ud835\\udd4f\\u00d0",
"url": null,
"description": "",
"protected": false,
"verified": false,
"followers_count": 166213349,
"friends_count": 506,
"listed_count": 149586,
"favourites_count": 37958,
"statuses_count": 34934,
"created_at": "2009-06-02T20:12:29.000000Z",
"profile_banner_url": "https:\\/\\/pbs.twimg.com\\/profile_banners\\/44196397\\/1690621312",
"profile_image_url_https": "https:\\/\\/pbs.twimg.com\\/profile_images\\/1683325380441128960\\/yRsRRjGO_normal.jpg",
"can_dm": false
},
"quoted_status_id_str": null,
"is_quote_status": false,
"quoted_status": null,
"retweeted_status": null,
"quote_count": 4,
"reply_count": 64,
"retweet_count": 30,
"favorite_count": 513,
"lang": "en",
"entities": {
"user_mentions": [
{
"id_str": "2852570664",
"name": "Ana Mostarac",
"screen_name": "anammostarac",
"indices": [
0,
13
]
}
],
"urls": [],
"hashtags": [],
"symbols": []
},
"views_count": 25579,
"bookmark_count": 3
}
]
}
```
#### 402
```json
{
"status": "error",
"message": "Insufficient balance"
}
```
#### 404
```json
{
"status": "error",
"message": "User not found"
}
```
#### 500
```json
{
"status": "error",
"message": "Failed to fetch data from Twitter"
}
```
## Response Codes
- **200 OK** - request succeeded
- **402 Payment Required** - not enough credits to perform this request
- **404 Not Found** - requested user not found
- **422 Unprocessable Content** - validation failed (e.g. one of the required parameters was not provided)
- **500 Internal Error** - API internal error, typically means that SocialData API failed to obtain the requested information and you should try again later
## Related endpoints
- [Get user tweets & replies](https://docs.socialdata.tools/reference/get-user-tweets-replies/)
- [Get user mentions](https://docs.socialdata.tools/reference/get-user-mentions/)
- [Get user highlights](https://docs.socialdata.tools/reference/get-user-highlights/)
## Before you integrate
- [Authentication](https://docs.socialdata.tools/getting-started/authentication/)
- [Rate limits](https://docs.socialdata.tools/getting-started/rate-limits/)
- [Errors](https://docs.socialdata.tools/getting-started/errors/)
- [Pricing](https://docs.socialdata.tools/getting-started/pricing/)