Profiles

Profile Details by Screen Name

Description

Retrieves the details of a user based on their screen name.

Endpoint

GET api/v1/realtime/social/twitter/v1/profile/{{screenName}}/details

Parameters

Param	Required	Param Type	Description
screenName	Yes	Path Param	String | The screen name of the Twitter user for whom details are to be retrieved.

Example Request

curl -X GET 'https://api.webit.live/api/v1/realtime/social/twitter/v1/profile/elonmusk/details' \
--header 'Authorization: Basic <credential string>'

Example Response

{
    "__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": {...},
    "fast_followers_count": 0,
    "favourites_count": 69802,
    "followers_count": 195594350,
    "friends_count": 723,
    "media_count": 2440,
    "normal_followers_count": 195594350,
    "pinned_tweet_ids_str": [...],
    "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": 50158,
    "verified": true,
    "withheld_in_countries": [],
    "verified_type": "Blue",
    "is_blue_verified": true,
    "affiliates_highlighted_label": {...},
    "business_account": {},
    "super_followed_by": false,
    "super_following": false,
    "private_super_following": false,
    "exclusive_tweet_following": false,
    "professional": {
        "professional_type": "Creator",
        "category": []
    }
}

---

Profile Details by ID

Description

Retrieves the details of a user based on their ID.

Endpoint

GET api/v1/realtime/social/twitter/v1/profile/{{identifier}}/details-by-id

Parameters

Param	Required	Param Type	Description
identifier	Yes	Path Param	String | The id of the Twitter user for whom details are to be retrieved.

Example Request

curl -X GET 'https://api.webit.live/api/v1/realtime/social/twitter/v1/profile/44196397/details-by-id' \
--header 'Authorization: Basic <credential string>'

Example Response

{
    "__typename": "User",
    "professional": {
        "professional_type": "Creator",
        "category": []
    },
    "rest_id": "44196397",
    "id_str": "44196397",
    "created_at": "Tue Jun 02 20:12:29 +0000 2009",
    "name": "Elon Musk",
    "screen_name": "elonmusk",
    "description": "",
    "location": "",
    "business_account": {},
    "entities": {
        "description": {
            "hashtags": [],
            "symbols": [],
            "urls": [],
            "info_urls": [],
            "user_mentions": []
        }
    },
    "fast_followers_count": 0,
    "favourites_count": 188773,
    "followers_count": 229678754,
    "friends_count": 1244,
    "media_count": 4262,
    "normal_followers_count": 229678754,
    "pinned_tweet_ids_str": [
        "1998463583831617855"
    ],
    "profile_banner_url": "https://pbs.twimg.com/profile_banners/44196397/1739948056",
    "profile_image_url_https": "https://pbs.twimg.com/profile_images/1995407795835772928/Wp7m4L9h_normal.jpg",
    "protected": false,
    "statuses_count": 90969,
    "verified": true,
    "withheld_in_countries": [],
    "verified_type": "Blue",
    "is_blue_verified": true,
    "super_followed_by": false,
    "super_following": false,
    "private_super_following": false,
    "exclusive_tweet_following": false,
    "affiliates_highlighted_label": {
        "label": {
            "badge": {
                "url": "https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg"
            },
            "userLabelType": "BusinessLabel",
            "description": "X",
            "url": {
                "urlType": "DeepLink",
                "url": "https://twitter.com/X"
            },
            "userLabelDisplayType": "Badge"
        }
    }
}

---

Profile Feed by Screen Name

Description

Retrieves the feed of a user based on their screen name.

Endpoint

GET api/v1/realtime/social/twitter/v1/profile/{{screenName}}/feed

Parameters

Param	Required	Param Type	Description
screenName	Yes	Path Param	String | The screen name of the Twitter user for whom details are to be retrieved.

Limitation

Subject	Value
Results per Request	<20 results
Total Results	No Limit

Example Request

curl -X GET 'https://api.webit.live/api/v1/realtime/social/twitter/v1/profile/elonmusk/feed' \
--header 'Authorization: Basic <credential string>'

Example Response

{
    "tweets": [
        {
            "entryId": "tweet-1827784062817202445",
            "tweet": {
                "__typename": "Tweet",
                "rest_id": "1827784062817202445",
                "url": "https://x.com/elonmusk/status/1827784062817202445",
                "view_count": "4442227",
                "conversation_id_str": "1827784062817202445",
                "created_at": "Sun Aug 25 19:04:13 +0000 2024",
                "full_text": "Yeah",
                "entities": {...},
                "favorite_count": 62792,
                "is_quote_status": true,
                "lang": "en",
                "quote_count": 449,
                "reply_count": 3707,
                "retweet_count": 13292,
                "retweeted": false,
                "user_id_str": "44196397",
                "user_details": {...},
                "quoted_status_result": {...},
                "is_retweet": false,
                "is_reply": false,
                "community_note": null
            }
        },
        ...
    ],
    "cursor_top": "...",
    "cursor_bottom": "..."
}

---

Profile Tweets by Id

Description

Retrieves the feed of a user based on their profileId. This feed is different from Profile Feed as it includes retweets.

Endpoint

GET api/v1/realtime/social/twitter/v1/profile/{{profileId}}/tweets

Parameters

Param	Required	Param Type	Description
profileId	Yes	Path Param	String | The unique identifier for X (twitter) profile whose information is to be retrieved

Limitation

Subject	Value
Results per Request	<20 results
Total Results	~700

Example Request

curl -X GET 'https://api.webit.live/api/v1/realtime/social/twitter/v1/profile/44196397/tweets' \
--header 'Authorization: Basic <credential string>'

Example Response

{
    "pinned_tweet": {
        "__typename": "Tweet",
        "rest_id": "1827551238893776956",
        "url": "https://x.com/elonmusk/status/1827551238893776956",
        "view_count": "32707938",
        "conversation_id_str": "1827551238893776956",
        "created_at": "Sun Aug 25 03:39:04 +0000 2024",
        "full_text": "“No guarantee of free speech” - Walz\nhttps://t.co/6JIHD5RWgW",
        "entities": {...},
        "favorite_count": 205032,
        "is_quote_status": false,
        "lang": "en",
        "quote_count": 7260,
        "reply_count": 23597,
        "retweet_count": 50472,
        "retweeted": false,
        "user_id_str": "44196397",
        "possibly_sensitive": false,
        "extended_entities": {...},
        "user_details": {...},
        "is_retweet": false,
        "is_reply": false,
        "community_note": null
    },
    "tweets": [
        {
            "entryId": "tweet-1827784062817202445",
            "tweet": {...}
        },
        ...
    ],
    "cursor_top": "DAABCgABGV3HDJDAJxEKAAIZXZfrzlbxDQgAAwAAAAEAAA",
    "cursor_bottom": "DAABCgABGV3HDJC__-gKAAIZXSGlLpohZQgAAwAAAAIAAA"
}

---

Profile Followers by Id

Description

Retrieves the followers of a user given a profileId.

Endpoint

GET api/v1/realtime/social/twitter/v1/profile/{{profileId}}/followers

Parameters

Param	Required	Param Type	Description
profileId	Yes	Path Param	String | The unique identifier for X (twitter) profile whose information is to be retrieved

Limitation

Subject	Value
Results per Request	50-70 results
Total Results	No Limit

Example Request

curl -X GET 'https://api.webit.live/api/v1/realtime/social/twitter/v1/profile/44196397/followers' \
--header 'Authorization: Basic <credential string>'

Example Response

{
    "users": [
        {
            "__typename": "User",
            "rest_id": "95092020",
            "id_str": "95092020",
            "created_at": "Sun Dec 06 23:33:02 +0000 2009",
            "name": "Dr Jordan B Peterson",
            "screen_name": "jordanbpeterson",
            "url": "https://t.co/LooUHeOv8e",
            "description": "Best-Selling Author | Clinical Psychologist | #1 Education Podcast | Enroll to @petersonacademy now:",
            "location": "",
            "entities": {...},
            "fast_followers_count": 0,
            "favourites_count": 159,
            "followers_count": 5489520,
            "friends_count": 1662,
            "media_count": 7218,
            "normal_followers_count": 5489520,
            "pinned_tweet_ids_str": [...],
            "profile_banner_url": "https://pbs.twimg.com/profile_banners/95092020/1724224295",
            "profile_image_url_https": "https://pbs.twimg.com/profile_images/1407056014776614923/TKBC60e1_normal.jpg",
            "protected": false,
            "statuses_count": 50429,
            "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": "-1|1827836417204551681",
    "cursor_bottom": "1808400506342578599|1827836417204551608"
}

---

Profile Following by Id

Description

Retrieves the users a user is following given a profileId.

Endpoint

GET api/v1/realtime/social/twitter/v1/profile/{{profileId}}/following

Parameters

Param	Required	Param Type	Description
profileId	Yes	Path Param	String | The unique identifier for X (twitter) profile whose information is to be retrieved

Limitation

Subject	Value
Results per Request	50-70 results
Total Results	No Limit

Example Request

curl -X GET 'https://api.webit.live/api/v1/realtime/social/twitter/v1/profile/44196397/following' \
--header 'Authorization: Basic <credential string>'

Example Response

{
    "users": [
        {
            "__typename": "User",
            "rest_id": "95092020",
            "id_str": "95092020",
            "created_at": "Sun Dec 06 23:33:02 +0000 2009",
            "name": "Dr Jordan B Peterson",
            "screen_name": "jordanbpeterson",
            "url": "https://t.co/LooUHeOv8e",
            "description": "Best-Selling Author | Clinical Psychologist | #1 Education Podcast | Enroll to @petersonacademy now:",
            "location": "",
            "entities": {...},
            "fast_followers_count": 0,
            "favourites_count": 159,
            "followers_count": 5489524,
            "friends_count": 1662,
            "media_count": 7218,
            "normal_followers_count": 5489524,
            "pinned_tweet_ids_str": [...],
            "profile_banner_url": "https://pbs.twimg.com/profile_banners/95092020/1724224295",
            "profile_image_url_https": "https://pbs.twimg.com/profile_images/1407056014776614923/TKBC60e1_normal.jpg",
            "protected": false,
            "statuses_count": 50429,
            "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": "-1|1827837408222117889",
    "cursor_bottom": "1805949879837852828|1827837408222117816"
}

---

Profile Highlights by Id

Description

Retrieves the highlights of a user given a profileId.

Endpoint

GET api/v1/realtime/social/twitter/v1/profile/{{profileId}}/highlights

Parameters

Param	Required	Param Type	Description
profileId	Yes	Path Param	String | The unique identifier for X (twitter) profile whose information is to be retrieved

Example Request

curl -X GET 'https://api.webit.live/api/v1/realtime/social/twitter/v1/profile/44196397/highlights' \
--header 'Authorization: Basic <credential string>'

Example Response

{
    "tweets": [
        {
            "entryId": "tweet-1827551238893776956",
            "tweet": {
                "__typename": "Tweet",
                "rest_id": "1827551238893776956",
                "url": "https://x.com/elonmusk/status/1827551238893776956",
                "view_count": "33009562",
                "conversation_id_str": "1827551238893776956",
                "created_at": "Sun Aug 25 03:39:04 +0000 2024",
                "full_text": "“No guarantee of free speech” - Walz\nhttps://t.co/6JIHD5RWgW",
                "entities": {...},
                "favorite_count": 206240,
                "is_quote_status": false,
                "lang": "en",
                "quote_count": 7307,
                "reply_count": 23775,
                "retweet_count": 50787,
                "retweeted": false,
                "user_id_str": "44196397",
                "possibly_sensitive": false,
                "extended_entities": {...},
                "user_details": {...},
                "is_retweet": false,
                "is_reply": false,
                "community_note": null
            }
        },
        ...
    ],
    "cursor_top": "DAAHCgABGV3Kz0CAAAELAAIAAAATMTgwODMzODM3MDA3NzE4MTY5NAgAAwAAAAEAAA",
    "cursor_bottom": "DAAHCgABGV3Kz0B__-wLAAIAAAATMTgwNjY0ODI1MjcxNTUxNDcyOQgAAwAAAAIAAA"
}

---

Profile Media by Screen Name

Description

Retrieves the media (photos, videos) a user has posted given a screenName.

Endpoint

GET api/v1/realtime/social/twitter/v1/profile/{{screenName}}/media

Parameters

Param	Required	Param Type	Description
screenName	Yes	Path Param	String | The screen name of the Twitter user for whom details are to be retrieved.

Limitation

Subject	Value
Results per Request	<20 results
Total Results	No Limit

Example Request

curl -X GET 'https://api.webit.live/api/v1/realtime/social/twitter/v1/profile/elonmusk/media' \
--header 'Authorization: Basic <credential string>'

Example Response

{
    "tweets": [
        {
            "entryId": "tweet-1827671903504597338",
            "tweet": {
                "__typename": "Tweet",
                "rest_id": "1827671903504597338",
                "url": "https://x.com/elonmusk/status/1827671903504597338",
                "view_count": "9781205",
                "conversation_id_str": "1827671903504597338",
                "created_at": "Sun Aug 25 11:38:32 +0000 2024",
                "full_text": "https://t.co/kkqPIguIRx",
                "entities": {...},
                "favorite_count": 81207,
                "is_quote_status": false,
                "lang": "zxx",
                "quote_count": 457,
                "reply_count": 3478,
                "retweet_count": 13447,
                "retweeted": false,
                "user_id_str": "44196397",
                "possibly_sensitive": false,
                "extended_entities": {...},
                "user_details": {...},
                "is_retweet": false,
                "is_reply": false,
                "community_note": null
            }
        },
        ...
    ],
    "cursor_top": "eyJjdXJzb3IiOiJEQUFEREFBQkNnQUJHVjB4NmE1YWdWb0tBQUlaVjlkdFh4dkJWZ0FJQUFJQUFBQUJDQUFEQUFBQUFBZ0FCQUFBQUFBS0FBVVpYY3RaTG9BbkVBb0FCaGxkeTFrdWY5andBQUEiLCJfcXVlcnlJZCI6IjQ3N2RlNjE4LTVkMjEtNGIzZi1iNTQ1LTNmMGMxZjQzNTdmOCJ9",
    "cursor_bottom": "eyJjdXJzb3IiOiJEQUFEREFBQkNnQUJHVjB4NmE1YWdWb0tBQUlaVjlkdFh4dkJWZ0FJQUFJQUFBQUNDQUFEQUFBQUFBZ0FCQUFBQUFBS0FBVVpYY3RaTG9BbkVBb0FCaGxkeTFrdWY5andBQUEiLCJfcXVlcnlJZCI6IjQ3N2RlNjE4LTVkMjEtNGIzZi1iNTQ1LTNmMGMxZjQzNTdmOCJ9"
}

---

Profile Replies by Screen Name

Description

Retrieves the replies a user has made given a screenName. Use this endpoint to see all replies a user has posted.

Endpoint

GET api/v1/realtime/social/twitter/v1/profile/{{screenName}}/replies

Parameters

Param	Required	Param Type	Description
screenName	Yes	Path Param	String | The screen name of the Twitter user for whom details are to be retrieved.

Limitation

Subject	Value
Results per Request	<20 results
Total Results	No Limit

Example Request

curl -X GET 'https://api.webit.live/api/v1/realtime/social/twitter/v1/profile/elonmusk/replies' \
--header 'Authorization: Basic <credential string>'

Example Response

{
    "tweets": [
            {
            "entryId": "tweet-1827784317356924997",
            "tweet": {
                "__typename": "Tweet",
                "rest_id": "1827784317356924997",
                "url": "https://x.com/elonmusk/status/1827784317356924997",
                "view_count": "43879",
                "conversation_id_str": "1827784115971674312",
                "created_at": "Sun Aug 25 19:05:14 +0000 2024",
                "full_text": "@stclairashley 😂",
                "entities": {...},
                "favorite_count": 1650,
                "is_quote_status": false,
                "lang": "qme",
                "quote_count": 6,
                "reply_count": 164,
                "retweet_count": 91,
                "retweeted": false,
                "user_id_str": "44196397",
                "in_reply_to_status_id_str": "1827784115971674312",
                "in_reply_to_screen_name": "stclairashley",
                "in_reply_to_user_id_str": "2874102076",
                "user_details": {...},
                "is_retweet": false,
                "is_reply": true,
                "community_note": null
            },
            ...
        }
    ],
    "cursor_top": "eyJjdXJzb3IiOiJEQUFEREFBQkNnQUJHVjJZSnhJVzRFVUtBQUlaWFJqWGtaYXhnZ0FJQUFJQUFBQUJDQUFEQUFBQUFBZ0FCQUFBQUFBS0FBVVpYY3djTXNBbkVBb0FCaGxkekJ3eXY5andBQUEiLCJfcXVlcnlJZCI6IjRmZDcyMDk3LTQxYzktNDIyYy1iYzZlLWNiZTM1YzIyYzIwNyJ9",
    "cursor_bottom": "eyJjdXJzb3IiOiJEQUFEREFBQkNnQUJHVjJZSnhJVzRFVUtBQUlaWFJqWGtaYXhnZ0FJQUFJQUFBQUNDQUFEQUFBQUFBZ0FCQUFBQUFBS0FBVVpYY3djTXNBbkVBb0FCaGxkekJ3eXY5andBQUEiLCJfcXVlcnlJZCI6IjRmZDcyMDk3LTQxYzktNDIyYy1iYzZlLWNiZTM1YzIyYzIwNyJ9"
}

---

Profile Lists Memberships By Id

Description

Retrieves the list a user is listed at given a profileId.

Endpoint

GET api/v1/realtime/social/twitter/v1/profile/{{profileId}}/lists/memberships

Parameters

Param	Required	Param Type	Description
profileId	Yes	Path Param	String | The unique identifier for X (twitter) profile whose information is to be retrieved

Limitation

Subject	Value
Results per Request	~10 results
Total Results	No Limit

Example Request

curl -X GET 'https://api.webit.live/api/v1/realtime/social/twitter/v1/profile/44196397/lists/memberships' \
--header 'Authorization: Basic <credential string>'

Example Response

{
    "lists": [
        {
            "list_id": "1827829658814939199",
            "list_name": "My follows",
            "list_description": null,
            "list_created_at": 1724623524000,
            "list_member_count": 44,
            "list_subscriber_count": null,
            "list_accessibility": "Public",
            "list_owner": {
                "__typename": "User",
                "rest_id": "837204479573442562",
                "id_str": "837204479573442562",
                "created_at": "Thu Mar 02 07:34:37 +0000 2017",
                "name": "concernedmom",
                "screen_name": "nishatnb",
                "description": "I’m Nishat, a former Democrat from NY who has seen the light. It was all fun and games until they targeted our kids.",
                "location": "New York, USA",
                "entities": {...},
                "fast_followers_count": 0,
                "favourites_count": 800,
                "followers_count": 295,
                "friends_count": 175,
                "media_count": 75,
                "normal_followers_count": 295,
                "pinned_tweet_ids_str": [...],
                "profile_banner_url": "https://pbs.twimg.com/profile_banners/837204479573442562/1722187740",
                "profile_image_url_https": "https://pbs.twimg.com/profile_images/1813359245930254336/5--T1aQv_normal.jpg",
                "protected": false,
                "statuses_count": 1463,
                "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": "eyJjdXJzb3IiOiItMXwxODI3ODQyMTQ5NjA1OTY1ODI1IiwiX3F1ZXJ5SWQiOiI1MjNhMGYyNi1iNjQxLTQ4MmYtYWIzNS1kY2YzMDVhYjFiMDcifQ==",
    "cursor_bottom": "eyJjdXJzb3IiOiI2NDM5NDgzODU5MjMxMjc3NDk5fDE4Mjc4NDIxNDk2MDU5NjU4MTEiLCJfcXVlcnlJZCI6IjUyM2EwZjI2LWI2NDEtNDgyZi1hYjM1LWRjZjMwNWFiMWIwNyJ9"
}

---

Profile About by Screen Name

Description

Retrieves the about information of a user based on their screen name.

Endpoint

GET api/v1/realtime/social/twitter/v1/profile/{{screenName}}/about

Parameters

Param	Required	Param Type	Description
screenName	Yes	Path Param	String | The screen name of the Twitter user for whom about information is to be retrieved.

Example Request

curl -X GET 'https://api.webit.live/api/v1/realtime/social/twitter/v1/profile/elonmusk/about \
--header 'Authorization: Basic <credential string>'

Example Response

{
    "user_id": "44196397",
    "username": "elonmusk",
    "display_name": "Elon Musk",
    "profile_image_url": "https://pbs.twimg.com/profile_images/1995407795835772928/Wp7m4L9h_normal.jpg",
    "is_verified": false,
    "is_blue_verified": true,
    "is_protected": false,
    "created_at": "2009-06-02T20:12:29.000Z",
    "verified_since": "-003000-01-24T12:26:40.000Z",
    "account_based_in": "United States",
    "location_accurate": false,
    "connection_source": "United States App Store",
    "username_changes_count": 0,
    "last_username_change": null
}

---