Nimble HomeLoginCreate an Account

User

Info

Description

Get a user's info by its sec ID. You can use the search user by keyword endpoint to find a user's sec ID. Learn about a user's name and nickname, profile photo, bio, statistics, and other social IDs if exists.

Endpoint

GET api/v1/realtime/social/tiktok/v1/user/{id}/info

Parameters

Param
Required
Param Type
Description

id

Yes

Path Param

String | The user sec ID

Example Request
curl -X GET 'https://api.webit.live/api/v1/realtime/social/tiktok/v1/user/MS4wLjABAAAAagrED-9e0PuAsTj1jvpOC5zJqYcDGio4mth3ITSox66IHjZXodqIGu0R274m59j0/info' \
--header 'Authorization: Basic <credential string>'
Example Response
{
    "nickname": "Kris Chanski",
    "user_name": "kris_chanski",
    "posts_count": 489,
    "uid": "6893209667481912326",
    "sec_uid": "MS4wLjABAAAAagrED-9e0PuAsTj1jvpOC5zJqYcDGio4mth3ITSox66IHjZXodqIGu0R274m59j0",
    "profile_photo": {
        "300x300": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast5-avt-0068-tx/18829b5dea9dcd612dca471c889d1609~c5_300x300.webp?lk3s=a5d48078&nonce=64043&refresh_token=aa2ff489b9a00b27728a54eff9ec7190&x-expires=1735657200&x-signature=WEd0hFWT5DtDFdwrBgSslWCNQLs%3D&shp=a5d48078&shcp=2472a6c6",
        "medium": "https://p19-pu-sign-useast8.tiktokcdn-us.com/tos-useast5-avt-0068-tx/18829b5dea9dcd612dca471c889d1609~c5_720x720.webp?lk3s=a5d48078&nonce=76788&refresh_token=fdd0db628381db22371e84b8ee0939c3&x-expires=1735657200&x-signature=8aYJQWgnvlJzCIKmSEQznQ%2Bwf08%3D&shp=a5d48078&shcp=2472a6c6",
        "larger": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast5-avt-0068-tx/18829b5dea9dcd612dca471c889d1609~c5_1080x1080.webp?lk3s=a5d48078&nonce=32062&refresh_token=0ca6b5b041cd36f494c620d05da02b11&x-expires=1735657200&x-signature=nuGyMjkSuNjyIKCw%2BqTbKF7kRoU%3D&shp=a5d48078&shcp=2472a6c6",
        "thumb": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast5-avt-0068-tx/18829b5dea9dcd612dca471c889d1609~c5_100x100.webp?lk3s=a5d48078&nonce=5926&refresh_token=0044c1bbb61f38ce2d114aa62f8009f7&x-expires=1735657200&x-signature=OV%2BMgfld9TuEqckQsxEmd3O2MeE%3D&shp=a5d48078&shcp=2472a6c6"
    },
    "biogprahy": "Boss Lady at The Range 702\nWork silliness \nLas Vegas",
    "following_count": 287,
    "followers_count": 278255,
    "verification_type": 0,
    "commerce_level": 0,
    "instagram_id": "kris_chanski",
    "youtube_channel_id": "UChH9gQHKvlZ4yJ8Cr746Hcw",
    "youtube_channel_title": "Kris Chanski",
    "total_posts_like_count": 7295476
}

Feed

Description

Fetch a user's feed by its sec ID. You can use the search user by keyword endpoint to find a user's sec ID. Up to 9 results per page.

Endpoint

GET api/v1/realtime/social/tiktok/v1/user/{id}/feed

Parameters

Param
Required
Param Type
Description

id

Yes

Path Param

String | The user sec ID

cursor

No

Query Param

String | Cursor for paginate data

Example Request
curl -X GET 'https://api.webit.live/api/v1/realtime/social/tiktok/v1/user/MS4wLjABAAAAagrED-9e0PuAsTj1jvpOC5zJqYcDGio4mth3ITSox66IHjZXodqIGu0R274m59j0/feed' \
--header 'Authorization: Basic <credential string>'
Example Response
{
    "posts": [
        {
            "post_id": "7330849414568856878",
            "desc": "Gotta shoot my shot.  #workfam #funny #bigirl #workdrama ",
            "desc_language": "en",
            "create_time": 1706846402,
            "region": "US",
            "branded_content_accounts": null,
            "is_ads": false,
            "is_on_this_day": 0,
            "is_top": 1,
            "is_vr": false,
            "music_begin_time_in_ms": 3595,
            "music_end_time_in_ms": 15229,
            "origin_volume": "7.591625",
            "paid_content_info": {
                "category": 0,
                "episode_num": 0,
                "is_paid_collection_intro": false,
                "paid_collection_id": 0,
                "should_show_series_purchase_label": false
            },
            "author": {},
            "statistics": {},
            "video": {},
            "mentions": [],
            "video_control": {},
            "music": {},
            "added_sound_music_info": {}
        }
    ],
    "pagination": {
        "cursor": "eyJvZmZzZXQiOjE3MzM1MDQ2OTgwMDB9",
        "has_more": true
    }
}

Followers

Description

Retrieve a user's followers list. For each follower, obtain basic information and the sec_id, which can be used with other endpoints to enrich the follower's data. 30 results per page, max 5000 results.

Endpoint

GET api/v1/realtime/social/tiktok/v1/user/{id}/followers

Parameters

Param
Required
Param Type
Description

id

Yes

Path Param

String | The user sec ID

cursor

No

Query Param

String | Cursor for paginate data

Example Request
curl -X GET 'https://api.webit.live/api/v1/realtime/social/tiktok/v1/user/MS4wLjABAAAAagrED-9e0PuAsTj1jvpOC5zJqYcDGio4mth3ITSox66IHjZXodqIGu0R274m59j0/followers' \
--header 'Authorization: Basic <credential string>'
Example Response
{
    "followers": [
        {
            "comment_setting": 0,
            "custom_verify": "",
            "fake_data_info": {},
            "follower_count": 844,
            "following_count": 781,
            "instagram_id": "",
            "is_ad_fake": false,
            "mention_status": "everyone",
            "nickname": "Habeeb Sodolamu",
            "sec_uid": "MS4wLjABAAAABg5_De4yoZFJqhUKYSPQRd1ogkYudcUNHTC5wmSBuVnXwMVoBtKzjMvOy7DcLUaz",
            "uid": "7406035260285404166",
            "username": "janetmary594",
            "verification_type": 1,
            "profile_photo": {
                "168x168": "https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/2a2bccd1c1f323a74d8082c6d7df1da4~tplv-tiktokx-cropcenter-q:168:168:q75.jpeg?dr=9604&idc=useast2a&nonce=37809&ps=87d6e48a&refresh_token=4ded770b839ffa630f0859712f654e47&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4",
                "300x300": "https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/2a2bccd1c1f323a74d8082c6d7df1da4~tplv-tiktokx-cropcenter-q:300:300:q75.jpeg?dr=9605&idc=useast2a&nonce=17337&ps=87d6e48a&refresh_token=0bd7de1d114f99f1c8dcf1e3fb857965&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4",
                "medium": "https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/2a2bccd1c1f323a74d8082c6d7df1da4~tplv-tiktokx-cropcenter-q:720:720:q75.jpeg?dr=9607&idc=useast2a&nonce=8991&ps=87d6e48a&refresh_token=521009b9bb415cf4b912eea101849ccc&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4",
                "larger": "https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/2a2bccd1c1f323a74d8082c6d7df1da4~tplv-tiktokx-cropcenter-q:1080:1080:q75.jpeg?dr=9608&idc=useast2a&nonce=91397&ps=87d6e48a&refresh_token=6c28ddda1d086afe75e80d52d35daa54&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4",
                "thumb": "https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/2a2bccd1c1f323a74d8082c6d7df1da4~tplv-tiktokx-cropcenter-q:100:100:q75.jpeg?dr=9606&idc=useast2a&nonce=24276&ps=87d6e48a&refresh_token=22074037c97954fd7f60a933f47c41a5&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4"
            }
        },
    ],
    "pagination": {
        "cursor": "eyJwYWdlVG9rZW4iOiJleUp0WVhoZlkzVnljMjl5SWpveE56TTFORGd4TlRVNExDSnRhVzVmWTNWeWMyOXlJam94TnpNMU5ESTVOVGswTENKbWFXNXBjMmhmYVc1elpYSjBYMjFoWmlJNmRISjFaWDA9IiwibWF4VGltZSI6MTczNTQyOTU5NH0=",
        "has_more": true
    }
}

Followings

Description

Retrieve a user's followers list. For each follower, obtain basic information and the sec_id, which can be used with other endpoints to enrich the follower's data. 30 results per page, max 5000 results.

Endpoint

GET api/v1/realtime/social/tiktok/v1/user/{id}/followings

Parameters

Param
Required
Param Type
Description

id

Yes

Path Param

String | The user sec ID

cursor

No

Query Param

String | Cursor for paginate data

Example Request
curl -X GET 'https://api.webit.live/api/v1/realtime/social/tiktok/v1/user/MS4wLjABAAAAagrED-9e0PuAsTj1jvpOC5zJqYcDGio4mth3ITSox66IHjZXodqIGu0R274m59j0/followings' \
--header 'Authorization: Basic <credential string>'
Example Response
{
    "followings": [
        {
            "comment_setting": 0,
            "custom_verify": "",
            "fake_data_info": {},
            "follower_count": 61375,
            "following_count": 1695,
            "instagram_id": "",
            "is_ad_fake": false,
            "mention_status": "everyone",
            "nickname": "Nurse_Kim",
            "sec_uid": "MS4wLjABAAAAa5A5CedbSOwz5tK2zvfPGinXsX8MJ6m72Omw3ttPJgEVJnOaC90V5jn_s229QGm0",
            "uid": "6810002435927999493",
            "username": "kj_rn1",
            "verification_type": 1,
            "profile_photo": {
                "168x168": "https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/4d7fe54a09d746bfa85cf0f13828747e~tplv-tiktokx-cropcenter-q:168:168:q75.jpeg?dr=9604&idc=useast2a&nonce=39366&ps=87d6e48a&refresh_token=88c1abf4109c763d345b721f9e344cf4&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4",
                "300x300": "https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/4d7fe54a09d746bfa85cf0f13828747e~tplv-tiktokx-cropcenter-q:300:300:q75.jpeg?dr=9605&idc=useast2a&nonce=68236&ps=87d6e48a&refresh_token=24c0eef6c66514c600a02f9989911600&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4",
                "medium": "https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/4d7fe54a09d746bfa85cf0f13828747e~tplv-tiktokx-cropcenter-q:720:720:q75.jpeg?dr=9607&idc=useast2a&nonce=75331&ps=87d6e48a&refresh_token=cfc2c4603b2104b73c712a00954667b8&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4",
                "larger": "https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/4d7fe54a09d746bfa85cf0f13828747e~tplv-tiktokx-cropcenter-q:1080:1080:q75.jpeg?dr=9608&idc=useast2a&nonce=18615&ps=87d6e48a&refresh_token=db834734ffeebf71c7fa4fa79697a2a6&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4",
                "thumb": "https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/4d7fe54a09d746bfa85cf0f13828747e~tplv-tiktokx-cropcenter-q:100:100:q75.jpeg?dr=9606&idc=useast2a&nonce=98016&ps=87d6e48a&refresh_token=9786b3b35cc3302c4751bd98bb500b13&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4"
            }
        },
    ],
    "pagination": {
        "cursor": "eyJwYWdlVG9rZW4iOiJleUp0WVhoZlkzVnljMjl5SWpveE56TTBNVEEwTWpnMUxDSnRhVzVmWTNWeWMyOXlJam94TnpJd05EQTBOekkzTENKbWFXNXBjMmhmYVc1elpYSjBYMjFoWmlJNmRISjFaWDA9IiwibWF4VGltZSI6MTcyMDQwNDcyN30=",
        "has_more": true
    }
}
PreviousPostNextWorkforce (Beta)

Last updated