Search

Search Top

Description

This endpoint retrieves the top results for a given query, making it ideal for finding the most popular tweets related to a specific keyword or topic.

Endpoint

GET api/v1/realtime/social/twitter/v1/search/top?query={{keyword}}

Parameters

Param	Required	Param Type	Description
query	Yes	Query Param	String | The search term used to find X (Twitter) top.
cursor	No	Query Param	This optional parameter points to the starting point of your search. If this is your first request, this parameter can be omitted. In subsequent requests, use the cursor returned by the previous request to paginate through results.

Limitation

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

Example Request

curl -X GET 'https://api.webit.live/api/v1/realtime/social/twitter/v1/search/top?query=elon musk' \
--header 'Authorization: Basic <credential string>'

Example Response

{
    "tweets": [
        {
            "entryId": "tweet-1827562759640301611",
            "tweet": {
                "__typename": "Tweet",
                "rest_id": "1827562759640301611",
                "url": "https://x.com/kamala_wins47/status/1827562759640301611",
                "view_count": "2090665",
                "conversation_id_str": "1827562759640301611",
                "created_at": "Sun Aug 25 04:24:51 +0000 2024",
                "full_text": "...",
                "entities": {...},
                "favorite_count": 97363,
                "is_quote_status": false,
                "lang": "en",
                "quote_count": 1416,
                "reply_count": 587,
                "retweet_count": 59637,
                "retweeted": false,
                "user_id_str": "1818044044439863299",
                "possibly_sensitive": false,
                "extended_entities": {...},
                "user_details": {...},
                "is_retweet": false,
                "is_reply": false,
                "community_note": null
            }
        },
        ...
    ],
    "users": [
        {
            "__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": 195585737,
            "friends_count": 723,
            "media_count": 2440,
            "normal_followers_count": 195585737,
            "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": {...},
            "super_followed_by": false,
            "super_following": false,
            "private_super_following": false,
            "exclusive_tweet_following": false
        },
        ...
    ],
    "cursor_top": "..."
}

---

Search Latest

Description

Retrieves the most recent results for given keywords or advanced queries without limits.

Endpoint

GET api/v1/realtime/social/twitter/v1/search/latest?query={{keyword}}

Parameters

Param	Required	Param Type	Description
query	Yes	Query Param	String | The search term used to find X (Twitter) latest.
cursor	No	Query Param	This optional parameter points to the starting point of your search. If this is your first request, this parameter can be omitted. In subsequent requests, use the cursor returned by the previous request to paginate through results.

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/search/latest?query=elon musk' \
--header 'Authorization: Basic <credential string>'

Example Response

{
    "tweets": [
        {
            "entryId": "tweet-1827828045061009904",
            "tweet": {
                "__typename": "Tweet",
                "rest_id": "1827828045061009904",
                "url": "https://x.com/MonicaWaite10/status/1827828045061009904",
                "conversation_id_str": "1827668394843251152",
                "created_at": "Sun Aug 25 21:59:00 +0000 2024",
                "full_text": "@elonmusk They’ve lost their minds!",
                "entities": {...},
                "favorite_count": 0,
                "is_quote_status": false,
                "lang": "en",
                "quote_count": 0,
                "reply_count": 0,
                "retweet_count": 0,
                "retweeted": false,
                "user_id_str": "1403781573842018311",
                "in_reply_to_status_id_str": "1827668394843251152",
                "in_reply_to_screen_name": "elonmusk",
                "in_reply_to_user_id_str": "44196397",
                "user_details": {...},
                "is_retweet": false,
                "is_reply": true,
                "community_note": null
            }
        },
    ],
    "cursor_top": "..."
}

---

Search Photos

Description

Retrieves photos related to a given query. This endpoint is useful when you want to discover photos related to a certain keyword or topic.

Endpoint

GET api/v1/realtime/social/twitter/v1/search/photos?query={{keyword}}

Parameters

Param	Required	Param Type	Description
query	Yes	Query Param	String | The search term used to find X (Twitter) photos.
cursor	No	Query Param	This optional parameter points to the starting point of your search. If this is your first request, this parameter can be omitted. In subsequent requests, use the cursor returned by the previous request to paginate through results.

Limitation

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

Example Request

curl -X GET 'https://api.webit.live/api/v1/realtime/social/twitter/v1/search/photos?query=elon musk' \
--header 'Authorization: Basic <credential string>'

Example Response

{
    "tweets": [
        {
            "entryId": "tweet-1672940669978001410",
            "tweet": {
                "__typename": "Tweet",
                "rest_id": "1672940669978001410",
                "url": "https://x.com/P_Kallioniemi/status/1672940669978001410",
                "view_count": "6814295",
                "conversation_id_str": "1672940669978001410",
                "created_at": "Sun Jun 25 12:11:52 +0000 2023",
                "full_text": "In today's #vatniksoup, I'll introduce an American businessman and social media figure, Elon Musk (@elonmusk). He's best-known for being the wealthiest man in the world, running companies like Tesla Inc., SpaceX and Twitter, and for parroting Kremlin's propaganda narratives.\n1/23 https://t.co/VmSZPfkVbw",
                "entities": {...},
                "favorite_count": 51633,
                "is_quote_status": false,
                "lang": "en",
                "quote_count": 1131,
                "reply_count": 1569,
                "retweet_count": 14311,
                "retweeted": false,
                "user_id_str": "1514502401486639110",
                "possibly_sensitive": false,
                "extended_entities": {...},
                "user_details": {...},
                "is_retweet": false,
                "is_reply": false,
                "community_note": null
            }
        },
        ...
    ],
    "cursor_top": "..."
}

---

Search Videos

Description

Retrieves videos related to a given query. This endpoint is useful when you want to find videos related to a certain keyword or topic.

Endpoint

GET api/v1/realtime/social/twitter/v1/search/latest?videos={{keyword}}

Parameters

Param	Required	Param Type	Description
query	Yes	Query Param	String | The search term used to find X (Twitter) videos.
cursor	No	Query Param	This optional parameter points to the starting point of your search. If this is your first request, this parameter can be omitted. In subsequent requests, use the cursor returned by the previous request to paginate through results.

Limitation

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

Example Request

curl -X GET 'https://api.webit.live/api/v1/realtime/social/twitter/v1/search/videos?query=elon musk' \
--header 'Authorization: Basic <credential string>'

Example Response

{
    "tweets": [
        {
            "entryId": "tweet-1827572720936030703",
            "tweet": {
                "__typename": "Tweet",
                "rest_id": "1827572720936030703",
                "url": "https://x.com/elonmusk/status/1827572720936030703",
                "view_count": "28133064",
                "conversation_id_str": "1827572720936030703",
                "created_at": "Sun Aug 25 05:04:25 +0000 2024",
                "full_text": "#FreePavel\n https://t.co/B7AcJWswMs",
                "entities": {...},
                "favorite_count": 299896,
                "is_quote_status": false,
                "lang": "qme",
                "quote_count": 4506,
                "reply_count": 12573,
                "retweet_count": 71366,
                "retweeted": false,
                "user_id_str": "44196397",
                "possibly_sensitive": false,
                "extended_entities": {...},
                "user_details": {...},
                "is_retweet": false,
                "is_reply": false,
                "community_note": null
            }
        },
        ...
    ],
    "cursor_top": "..."
}

---

Search People

Description

Retrieves profiles related to a given query. This endpoint is helpful when you want to find users related to a certain name, keyword or topic.

Endpoint

GET api/v1/realtime/social/twitter/v1/search/latest?people={{keyword}}

Parameters

Param	Required	Param Type	Description
query	Yes	Query Param	String | The search term used to find X (Twitter) people.
cursor	No	Query Param	This optional parameter points to the starting point of your search. If this is your first request, this parameter can be omitted. In subsequent requests, use the cursor returned by the previous request to paginate through results.

Limitation

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

Example Request

curl -X GET 'https://api.webit.live/api/v1/realtime/social/twitter/v1/search/people?query=elon musk' \
--header 'Authorization: Basic <credential string>'

Example Response

{
    "users": [
        {
            "__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": 195589571,
            "friends_count": 723,
            "media_count": 2440,
            "normal_followers_count": 195589571,
            "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": {...},
            "super_followed_by": false,
            "super_following": false,
            "private_super_following": false,
            "exclusive_tweet_following": false
        },
        ...
    ],
    "cursor_top": "...",
    "cursor_bottom": "..."
}