Nimble Home Login Create an Account

Tweets

Tweet Details

Description

Retrieves the details of a tweet based on its identifier.

Endpoint

GET api/v1/realtime/social/twitter/v1/tweet/{{tweetId}}/details

Parameters

ParamRequiredParam TypeDescription

tweetId

Yes

Path Param

String | The unique identifier for X (twitter) tweet whose information is to be retrieved

Example Request
curl -X GET 'https://api.webit.live/api/v1/realtime/social/twitter/v1/tweet/1675187969420828672/details' \
--header 'Authorization: Basic <credential string>'
Example Response
{
    "entryId": "tweet-1675187969420828672",
    "tweet": {
        "__typename": "Tweet",
        "rest_id": "1675187969420828672",
        "url": "https://x.com/elonmusk/status/1675187969420828672",
        "view_count": "606501950",
        "conversation_id_str": "1675187969420828672",
        "created_at": "Sat Jul 01 17:01:50 +0000 2023",
        "full_text": "To address extreme levels of data scraping &amp; system manipulation, we’ve applied the following temporary limits:\n\n- Verified accounts are limited to reading 6000 posts/day\n- Unverified accounts to 600 posts/day\n- New unverified accounts to 300/day",
        "entities": {
            "hashtags": [],
            "symbols": [],
            "urls": [],
            "user_mentions": []
        },
        "favorite_count": 438583,
        "is_quote_status": false,
        "lang": "en",
        "quote_count": 439514,
        "reply_count": 190137,
        "retweet_count": 105224,
        "retweeted": false,
        "user_id_str": "44196397",
        "user_details": {
            "__typename": "User",
            "rest_id": "44196397",
            "id_str": "44196397",
            "created_at": "Tue Jun 02 20:12:29 +0000 2009",
            "name": "Elon Musk",
            "screen_name": "elonmusk",
            "description": "",
            "location": "",
            "entities": {
                "description": {
                    "hashtags": [],
                    "symbols": [],
                    "urls": [],
                    "user_mentions": []
                }
            },
            "fast_followers_count": 0,
            "favourites_count": 69834,
            "followers_count": 195666392,
            "friends_count": 724,
            "media_count": 2443,
            "normal_followers_count": 195666392,
            "pinned_tweet_ids_str": [
                "1827551238893776956"
            ],
            "profile_banner_url": "https://pbs.twimg.com/profile_banners/44196397/1722660499",
            "profile_image_url_https": "https://pbs.twimg.com/profile_images/1815749056821346304/jS8I28PL_normal.jpg",
            "protected": false,
            "statuses_count": 50169,
            "verified": true,
            "withheld_in_countries": [],
            "verified_type": "Blue",
            "is_blue_verified": true,
            "affiliates_highlighted_label": {
                "label": {
                    "url": {
                        "urlType": "DeepLink",
                        "url": "https://twitter.com/X"
                    },
                    "badge": {
                        "url": "https://pbs.twimg.com/profile_images/1683899100922511378/5lY42eHs_bigger.jpg"
                    },
                    "userLabelType": "BusinessLabel",
                    "userLabelDisplayType": "Badge",
                    "description": "X"
                }
            },
            "super_followed_by": false,
            "super_following": false,
            "private_super_following": false,
            "exclusive_tweet_following": false
        },
        "is_retweet": false,
        "is_reply": false,
        "community_note": null
    }
}

Tweets Retweets

Description

Retrieves the list of users who retweeted a given tweet.

Endpoint

GET api/v1/realtime/social/twitter/v1/tweet/{{tweetId}}/retweets

Parameters

ParamRequiredParam TypeDescription

tweetId

Yes

Path Param

String | The unique identifier for X (twitter) tweet whose information is to be retrieved

Limitation

SubjectValue

Results per Request

~100 results

Total Results

No Limit

Example Request
curl -X GET 'https://api.webit.live/api/v1/realtime/social/twitter/v1/tweet/1675187969420828672/retweets' \
--header 'Authorization: Basic <credential string>'
Example Response
{
    "users": [
        {
            "__typename": "User",
            "rest_id": "704368799",
            "id_str": "704368799",
            "created_at": "Tue Oct 08 02:35:26 +0000 2013",
            "name": "WillieBey",
            "screen_name": "QbusterWill",
            "description": "Cancer drug research in the UK & USA, then 20 years as MD of pharma affiliates in Turkey, RSA & India. Now appalled that #BigPharma puts profit before humanity.",
            "location": "England ",
            "entities": {...},
            "fast_followers_count": 0,
            "favourites_count": 4273,
            "followers_count": 2150,
            "friends_count": 7503,
            "media_count": 232,
            "normal_followers_count": 2150,
            "pinned_tweet_ids_str": [],
            "profile_banner_url": "https://pbs.twimg.com/profile_banners/704368799/1694438493",
            "profile_image_url_https": "https://pbs.twimg.com/profile_images/1479877853839872004/3BVy_AcP_normal.jpg",
            "protected": false,
            "statuses_count": 5815,
            "verified": true,
            "withheld_in_countries": [],
            "verified_type": "Blue",
            "is_blue_verified": true,
            "affiliates_highlighted_label": {},
            "super_followed_by": false,
            "super_following": false,
            "private_super_following": false,
            "exclusive_tweet_following": false
        },
        ...
    ],
    "cursor_top": "HCag6//N/IDkkTIAAA==",
    "cursor_bottom": "HBayndCZ2eu66TEAAA=="
}

Tweets Quotes

Description

Retrieves the quotes of a given tweet.

Endpoint

GET api/v1/realtime/social/twitter/v1/tweet/{{tweetId}}/quotes

Parameters

ParamRequiredParam TypeDescription

tweetId

Yes

Path Param

String | The unique identifier for X (twitter) tweet whose information is to be retrieved

Limitation

SubjectValue

Results per Request

<20 results

Total Results

No Limit

Example Request
curl -X GET 'https://api.webit.live/api/v1/realtime/social/twitter/v1/tweet/1675187969420828672/quotes' \
--header 'Authorization: Basic <credential string>'
Example Response
{
    "tweets": [
        {
            "entryId": "tweet-1827380941666267172",
            "tweet": {
                "__typename": "Tweet",
                "rest_id": "1827380941666267172",
                "url": "https://x.com/TayluhSwiff13/status/1827380941666267172",
                "view_count": "68",
                "conversation_id_str": "1827380941666267172",
                "created_at": "Sat Aug 24 16:22:22 +0000 2024",
                "full_text": "Y’all remember when Elon musk tried to limit how many tweets we could read 😭😭😭😭",
                "entities": {...},
                "favorite_count": 0,
                "is_quote_status": true,
                "lang": "en",
                "quote_count": 0,
                "reply_count": 0,
                "retweet_count": 0,
                "retweeted": false,
                "user_id_str": "1184473143039143936",
                "user_details": {...},
                "quoted_status_result": {...},
                "is_retweet": false,
                "is_reply": false,
                "community_note": null
            }
        }
    ],
    "cursor_top": "eyJjdXJzb3IiOiJEQUFEREFBQkNnQUJHVndwU05sV01DUUtBQUlaSWpMSnZ4cFJXd0FJQUFJQUFBQUJDQUFEQUFBQUFBZ0FCQUFBQUFBS0FBVVpYa1ZNZFlBbkVBb0FCaGxlUlV4MWY5andBQUEiLCJfcXVlcnlJZCI6IjQwYzIzNDcxLTQ1ODQtNDhlMy1hNjU2LWM0NmE1YjE2NzA5ZCJ9",
    "cursor_bottom": "eyJjdXJzb3IiOiJEQUFEREFBQkNnQUJHVndwU05sV01DUUtBQUlaSWpMSnZ4cFJXd0FJQUFJQUFBQUNDQUFEQUFBQUFBZ0FCQUFBQUFBS0FBVVpYa1ZNZFlBbkVBb0FCaGxlUlV4MWY5andBQUEiLCJfcXVlcnlJZCI6IjQwYzIzNDcxLTQ1ODQtNDhlMy1hNjU2LWM0NmE1YjE2NzA5ZCJ9"
}

Tweets Replies

Description

Retrieves replies of a given tweet.

Can also be used to retrieve replies of a reply by using the id of that reply. When requesting replies of a reply, the response will contain the original tweet as the first tweet, the second tweet will be the reply to the original (the one that you used the id of in this request) and then the replies of the reply.

Inside the tweets array the first response will look like this:

  • Original tweet

  • reply to the original (this is the requested id)

  • first reply to the reply

  • second reply to the reply

  • and so on

After the first response the responses will only contain the replies.

Endpoint

GET api/v1/realtime/social/twitter/v1/tweet/{{tweetId}}/replies

Parameters

ParamRequiredParam TypeDescription

tweetId

Yes

Path Param

String | The unique identifier for X (twitter) tweet whose information is to be retrieved

Limitation

SubjectValue

Results per Request

10 results

Total Results

~200

Example Request
curl -X GET 'https://api.webit.live/api/v1/realtime/social/twitter/v1/tweet/1675187969420828672/replies' \
--header 'Authorization: Basic <credential string>'
Example Response
{
    "tweets": [
        {
            "entryId": "tweet-1675187969420828672",
            "tweet": {
                "__typename": "Tweet",
                "rest_id": "1675187969420828672",
                "url": "https://x.com/elonmusk/status/1675187969420828672",
                "view_count": "606501996",
                "conversation_id_str": "1675187969420828672",
                "created_at": "Sat Jul 01 17:01:50 +0000 2023",
                "full_text": "To address extreme levels of data scraping &amp; system manipulation, we’ve applied the following temporary limits:\n\n- Verified accounts are limited to reading 6000 posts/day\n- Unverified accounts to 600 posts/day\n- New unverified accounts to 300/day",
                "entities": {...},
                "favorite_count": 438575,
                "is_quote_status": false,
                "lang": "en",
                "quote_count": 439522,
                "reply_count": 190137,
                "retweet_count": 105221,
                "retweeted": false,
                "user_id_str": "44196397",
                "user_details": {...},
                "is_retweet": false,
                "is_reply": false,
                "community_note": null
            }
        },
        ...
    ],
    "cursor_bottom": "ZAAAAPAWHBmmhMCznaLyx78ugICxoYmC_r8ugoC-reb-w78ugMDS3Z6Y2hsAUL3pqa2_CQDgsKWyw5fALoCA0fn2zbsSAFHTrdv1yBsAMdnJvxIA4Lzxsr3vvy4lAhIVBAAA"
}

Last updated