# Retrieve all users who liked a tweet

{% hint style="danger" %} <mark style="color:red;">**Due to Twitter's decision to make likes private for all users, this endpoint is unable to provide any data.**</mark>
{% endhint %}

### Endpoint

```url
GET https://api.socialdata.tools/twitter/tweets/[tweet_id]/liking_users
```

### Endpoint parameters

| Name                                            | Description                                               | Example              |
| ----------------------------------------------- | --------------------------------------------------------- | -------------------- |
| <p>tweet\_id<br><strong>(Required)</strong></p> | The numerical ID of the desired Tweet.                    | 1729591119699124560  |
| <p>cursor<br>(optional)</p>                     | Cursor value obtained from next\_cursor response property | HBbS87H7icrezjEAAA== |

### Response codes

* **HTTP 200 OK -** succeeded
* **HTTP 402 Payment Required** - not enough credits to perform this request
* **HTTP 404 Not Found** - requested tweet does not exist
* **HTTP 422 Unprocessable Content** - validation failed (e.g. one of the required parameters was not provided)
* **HTTP 500** **Internal Server Error** - other error, typically means that SocialData API failed to obtain the requested information and you should try again later

### Rate limits

By default each user has a limit of 120 requests per minute shared across all endpoints. Please reach out to <support@socialdata.tools> if you need to raise your rate limit.

### Example request

```bash
curl "https://api.socialdata.tools/twitter/tweets/1625802236571033602/liking_users"
-H 'Authorization: Bearer API_KEY'
-H 'Accept: application/json'
```

[![Run In Postman](https://run.pstmn.io/button.svg)](https://god.gw.postman.com/run-collection/36444222-9d3f261a-6fc3-44cd-90eb-f0d191d6d1a8?action=collection%2Ffork\&source=rip_markdown\&collection-url=entityId%3D36444222-9d3f261a-6fc3-44cd-90eb-f0d191d6d1a8%26entityType%3Dcollection%26workspaceId%3D22407140-425b-41ff-969e-1fb938fe8e86)

### Example response

```json
// If succeeded: 
{
    "next_cursor": "HBbS87H7icrezjEAAA==",
    "users": [
        {
            "id": 1547124452596523008,
            "id_str": "1547124452596523008",
            "name": "Gwendal Brossard",
            "screen_name": "GwendalBrossard",
            "location": "Building",
            "url": "https:\/\/t.co\/6o4TTYu7LQ",
            "description": "I'm an indie maker building products \ud83d\udc68\u200d\ud83d\udcbb @PaletteBrain\u2506https:\/\/t.co\/BEadk6UDlz \u2728",
            "protected": false,
            "verified": false,
            "followers_count": 3557,
            "friends_count": 149,
            "listed_count": 41,
            "favourites_count": 12425,
            "statuses_count": 6778,
            "created_at": "2022-07-13T07:43:56.000000Z",
            "profile_banner_url": "https:\/\/pbs.twimg.com\/profile_banners\/1547124452596523008\/1672736091",
            "profile_image_url_https": "https:\/\/pbs.twimg.com\/profile_images\/1572151372455313409\/qq1yH56d_normal.jpg",
            "can_dm": true
        },
        ...
    ]
}

// If failed:
{
    "status":"error",
    "message":"Tweet not found"
}
```
