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
String | The screen name of the Twitter user for whom details are to be retrieved. This parameter is required.
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 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}}/details
Parameters
Param
Required
Param Type
Description
String | The screen name of the Twitter user for whom details are to be retrieved. This parameter is required.
Limitation
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": "..."
}
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
String | The unique identifier for X (twitter) profile whose information is to be retrieved
Limitation
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
String | The unique identifier for X (twitter) profile whose information is to be retrieved
Limitation
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
String | The unique identifier for X (twitter) profile whose information is to be retrieved
Limitation
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
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
String | The screen name of the Twitter user for whom details are to be retrieved. This parameter is required.
Limitation
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
String | The screen name of the Twitter user for whom details are to be retrieved. This parameter is required.
Limitation
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
String | The unique identifier for X (twitter) profile whose information is to be retrieved
Limitation
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"
}
