Nimble HomeLoginCreate an Account

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

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
    }
}
PreviousURL ResolverNextPost

Last updated