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) users.

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) users.

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.

Endpont

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) users.

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) users.

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) users.

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": "..."
}

Last updated 4 months ago