Search

Discover Hashtag

Description

Search for hashtags that are similar to a keyword. For each hashtag, get its ID, use count and view count. You can use the hashtag ID to search posts by hashtags. Up to 20 results per page, up to 300 results total.

Endpoint

GET api/v1/realtime/social/tiktok/v1/search/discover-hashtags?query={query}

Parameters

Param	Required	Param Type	Description
query	Yes	Query Param	String | The search keyword
cursor	No	Query Param	String | Cursor for paginate data

Example Request

curl -X GET 'https://api.webit.live/api/v1/realtime/social/tiktok/v1/search/discover-hashtags?query=nba' \
--header 'Authorization: Basic <credential string>'

Example Response

{
    "keyword": "nba",
    "page_results": 20,
    "hashtag_list": [
        {
            "hashtag_name": "NBA",
            "id": "12744",
            "use_count": 12823778,
            "view_count": 322470126569,
            "is_commerce": false,
            "is_professional_generated_content": false,
            "desc": "The #NBA Draft is here, so whether you're heading to New York or dreaming of the perfect pick, we're here for all things #NBA."
        },
        {
            "hashtag_name": "nbabrasil",
            "id": "43649359",
            "use_count": 48366,
            "view_count": 1056529435,
            "is_commerce": false,
            "is_professional_generated_content": false,
            "desc": ""
        },
        {
            "hashtag_name": "nbamoments",
            "id": "9942648",
            "use_count": 276404,
            "view_count": 5466100450,
            "is_commerce": false,
            "is_professional_generated_content": false,
            "desc": "Whether you're draining a game-winner in your living room or pulling up from deep in your backyard, grab a ball and recreate your favorite #NBAMoments."
        },
        {
            "hashtag_name": "nbarecord",
            "id": "11054832",
            "use_count": 906,
            "view_count": 38624490,
            "is_commerce": false,
            "is_professional_generated_content": false,
            "desc": ""
        },
        {
            "hashtag_name": "nbaespañol",
            "id": "1666537832410117",
            "use_count": 7945,
            "view_count": 408924313,
            "is_commerce": false,
            "is_professional_generated_content": false,
            "desc": ""
        },
        {
            "hashtag_name": "nbatraining",
            "id": "1648674154234886",
            "use_count": 1992,
            "view_count": 21406378,
            "is_commerce": false,
            "is_professional_generated_content": false,
            "desc": ""
        },
        {
            "hashtag_name": "nbameme",
            "id": "1620963188063717",
            "use_count": 10683,
            "view_count": 445716313,
            "is_commerce": false,
            "is_professional_generated_content": false,
            "desc": ""
        },
        {
            "hashtag_name": "nbaanalysis",
            "id": "1660870176184325",
            "use_count": 3592,
            "view_count": 37258440,
            "is_commerce": false,
            "is_professional_generated_content": false,
            "desc": ""
        },
        {
            "hashtag_name": "nba?",
            "id": "1648052559016965",
            "use_count": 532,
            "view_count": 10811332,
            "is_commerce": false,
            "is_professional_generated_content": false,
            "desc": ""
        },
        {
            "hashtag_name": "nbavideos",
            "id": "3974342",
            "use_count": 15604,
            "view_count": 520370742,
            "is_commerce": false,
            "is_professional_generated_content": false,
            "desc": ""
        },
        {
            "hashtag_name": "nbaentrance",
            "id": "1645441428858885",
            "use_count": 53640,
            "view_count": 702440455,
            "is_commerce": false,
            "is_professional_generated_content": false,
            "desc": "Whether you’re here to make a statement in your best outfit or stay cozy in your sweats, show us how you’d make your #NBAEntrance with you pregame worthy fit."
        },
        {
            "hashtag_name": "nbahumor",
            "id": "1615411213772805",
            "use_count": 1654,
            "view_count": 21321834,
            "is_commerce": false,
            "is_professional_generated_content": false,
            "desc": ""
        },
        {
            "hashtag_name": "nbacouple",
            "id": "1656216891364358",
            "use_count": 169,
            "view_count": 45634627,
            "is_commerce": false,
            "is_professional_generated_content": false,
            "desc": ""
        },
        {
            "hashtag_name": "nbafunny",
            "id": "17722337",
            "use_count": 15244,
            "view_count": 1034985014,
            "is_commerce": false,
            "is_professional_generated_content": false,
            "desc": ""
        },
        {
            "hashtag_name": "nbaphilippines",
            "id": "1666047746278402",
            "use_count": 9382,
            "view_count": 461156132,
            "is_commerce": false,
            "is_professional_generated_content": false,
            "desc": ""
        },
        {
            "hashtag_name": "basketballnba",
            "id": "6516729",
            "use_count": 8538,
            "view_count": 51842366,
            "is_commerce": false,
            "is_professional_generated_content": false,
            "desc": ""
        },
        {
            "hashtag_name": "nbaclips",
            "id": "70544308",
            "use_count": 14321,
            "view_count": 287911669,
            "is_commerce": false,
            "is_professional_generated_content": false,
            "desc": ""
        },
        {
            "hashtag_name": "nbadunkweek",
            "id": "1639783303115782",
            "use_count": 1351,
            "view_count": 69937045,
            "is_commerce": false,
            "is_professional_generated_content": false,
            "desc": ""
        },
        {
            "hashtag_name": "nbaallstars",
            "id": "6393706",
            "use_count": 7235,
            "view_count": 75329006,
            "is_commerce": false,
            "is_professional_generated_content": false,
            "desc": ""
        },
        {
            "hashtag_name": "nbababies",
            "id": "86016656",
            "use_count": 1228,
            "view_count": 48882257,
            "is_commerce": false,
            "is_professional_generated_content": false,
            "desc": ""
        }
    ],
    "pagination": {
        "cursor": "eyJvZmZzZXQiOjIwLCJyZXF1ZXN0RW50aXR5SWQiOiIyMDI0MTIyOTE1NTgwNzYxQTY2NThBMzkwQ0JCNTQ0MTg4In0=",
        "hasMore": true
    }
}

---

Post by Keyword

Description

Search for posts by a keyword. You can choose the country to search from, as it affects the results. For each post, get its content (text, hashtags, mentions, media), statistics such as likes count, views, comments count, shares, etc., author info, music info and more. Up to 10 results per page. returns around 200 results total. To get more results, try using the search posts by hashtags which returns up to 5000 results.

Endpoint

GET api/v1/realtime/social/tiktok/v1/search/posts-by-keyword?keyword={keyword}

Parameters

Param	Required	Param Type	Description
keyword	Yes	Query Param	String | The search keyword
cursor	No	Query Param	String | Cursor for paginate data
country_code	No	Query Param	String | Country code to adjust the results with
publish_time	No	Query Param	String | Show posts from the last (X) days
sort_type	No	Query Param	Enum | Determine the sort type: relevance | likes | data

Supported country codes: IR, QC, SA, CN, JP, AU, IN, KR, ID, TH, AR, BR, CA, CY, EG, FR, DE, GR, IL, IT, LB, MX, PA, PT, RU, ES, SE, TR, GB, US, ML, PH, VN, MY, PK, PL, KH, NL, CO, CL, PE, JO, MA, AE, SG, TW

Example Request

curl -X GET 'https://api.webit.live/api/v1/realtime/social/tiktok/v1/search/posts-by-keyword?keyword=nba' \
--header 'Authorization: Basic <credential string>'

Example Response

{
    "page_results": 10,
    "posts": [
        {
            "post_id": "7453659945565785375",
            "desc": "Steph doing Steph things 🪄👏 @warriors #NBA #Basketball #Warriors #StephCurry ",
            "desc_language": "en",
            "create_time": 1735440454,
            "region": "US",
            "branded_content_accounts": null,
            "is_ads": false,
            "is_on_this_day": 0,
            "is_top": 0,
            "is_vr": false,
            "music_begin_time_in_ms": 0,
            "music_end_time_in_ms": 12279,
            "origin_volume": "50.000000",
            "paid_content_info": {},
            "author": {},
            "statistics": {},
            "video": {},
            "mentions": [],
            "video_control": {},
            "music": {},
            "added_sound_music_info": {}
        },   
    ],
    "pagination": {
        "cursor": "eyJvZmZzZXQiOjEwLCJyZXF1ZXN0RW50aXR5SWQiOiIyMDI0MTIyOTE2MDA1NTg5MjYxMjc2OEEyNTc3NTQxOEEyIn0=",
        "hasMore": true
    }
}

---

Post by Hashtag

Description

Search for posts by hashtag ID. To get the ID of the hashtag, use the discover hashtags endpoint. For each post, get its content (text, hashtags, mentions, media), statistics such as likes count, views, comments count, shares, etc., author info, music info and more. Up to 20 results per page, up to 5000 results total.

Endpoint

GET api/v1/realtime/social/tiktok/v1/search/posts-by-hashtag?hashtag_id={hashtag_id}

Parameters

Param	Required	Param Type	Description
hashtag_id	Yes	Query Param	String | The hashtag ID
cursor	No	Query Param	String | Cursor for paginate data
country_code	No	Query Param	String | Country code to adjust the results with

Supported country codes: IR, QC, SA, CN, JP, AU, IN, KR, ID, TH, AR, BR, CA, CY, EG, FR, DE, GR, IL, IT, LB, MX, PA, PT, RU, ES, SE, TR, GB, US, ML, PH, VN, MY, PK, PL, KH, NL, CO, CL, PE, JO, MA, AE, SG, TW

Example Request

curl -X GET 'https://api.webit.live/api/v1/realtime/social/tiktok/v1/search/posts-by-hashtag?hashtag_id=5131' \
--header 'Authorization: Basic <credential string>'

Example Response

{
    "page_results": 18,
    "posts": [
        {
            "post_id": "7203451156264144133",
            "desc": "#Viral #viral #kosova #mehlemi #meda Hajde viral qeta! 😍",
            "desc_language": "st",
            "create_time": 1677184172,
            "region": "DE",
            "branded_content_accounts": null,
            "is_ads": false,
            "is_on_this_day": 0,
            "is_top": 0,
            "is_vr": false,
            "music_begin_time_in_ms": 0,
            "music_end_time_in_ms": 116888,
            "origin_volume": "50.000000",
            "paid_content_info": {},
            "author": {},
            "statistics": {},
            "video": {},
            "mentions": [],
            "video_control": {},
            "music": {},
            "added_sound_music_info": {}
        }
    ],
    "pagination": {
        "cursor": "eyJvZmZzZXQiOjIwLCJyZXF1ZXN0RW50aXR5SWQiOiIyMDI0MTIyOTE2MDQzMEQ2RTdDOTc5OTE2RjM1NTQzMzYyIn0=",
        "hasMore": true
    }
}

---

Discover Users

Description

Search for users by a keyword, and get a list of users who's username might be related to the keyword. For each user, get its user info - ID, nickname, posts count, follower and following count and more. Up to 10 results per page, around 300 results total.

Endpoint

GET api/v1/realtime/social/tiktok/v1/search/discover-users?keyword={keyword}

Parameters

Param	Required	Param Type	Description
keyword	Yes	Query Param	String | The keyword to use for the search
cursor	No	Query Param	String | Cursor for paginate data

Example Request

curl -X GET 'https://api.webit.live/api/v1/realtime/social/tiktok/v1/search/discover-users?keyword=sonos'\
--header 'Authorization: Basic <credential string>'

Example Response

{
    "input_keyword": "sonos",
    "users": [
        {
            "posts_count": 56,
            "is_private_account": 0,
            "total_favorited": 78469,
            "comment_setting": 0,
            "custom_verify": "",
            "fake_data_info": {},
            "follower_count": 38349,
            "following_count": 51,
            "instagram_id": "sonos",
            "is_ad_fake": false,
            "mention_status": "everyone",
            "nickname": "Sonos",
            "sec_uid": "MS4wLjABAAAA7dpMbtPT8J5u2qgtH3ECwQoXPM38UZtcu0kTfmvmP0v_hriQJqdW8C-C060Yafjc",
            "uid": "7102548232783381550",
            "username": "sonos",
            "verification_type": 0,
            "profile_photo": {
                "168x168": "https://p16-pu-useast8.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7347257059731046442~tplv-tiktokx-cropcenter-q:168:168:q70.heic?dr=8833&idc=useast5&nonce=58459&ps=87d6e48a&refresh_token=73e144461bc7defa308c798013d0c265&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4",
                "300x300": "https://p16-pu-useast8.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7347257059731046442~tplv-tiktokx-cropcenter-q:300:300:q70.heic?dr=8834&idc=useast5&nonce=75668&ps=87d6e48a&refresh_token=59a56fa5ba5c9f39b5feb6a409294151&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4",
                "medium": "https://p16-pu-useast8.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7347257059731046442~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=8836&idc=useast5&nonce=81550&ps=87d6e48a&refresh_token=bd5270343625efba98326088f32df9f2&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4",
                "larger": "https://p16-pu-useast8.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7347257059731046442~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=8837&idc=useast5&nonce=6977&ps=87d6e48a&refresh_token=ae11c68a610fab454a6a2a0ec9bf5438&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4",
                "thumb": "https://p16-pu-useast8.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7347257059731046442~tplv-tiktokx-cropcenter-q:100:100:q70.heic?biz_tag=musically_user.user_cover&dr=8835&idc=useast5&nonce=91835&ps=87d6e48a&refresh_token=bd931ba59f295591cc5871c235e8894a&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4"
            }
        }
    ],
    "pagination": {
        "cursor": "eyJvZmZzZXQiOjEwLCJyZXF1ZXN0RW50aXR5SWQiOiIyMDI0MTIyOTE2MDc0N0QzRjY4ODFFRDcxRUEzNUVFNEQ3In0=",
        "hasMore": true
    }
}

---