DEV Community

tokinsight
tokinsight

Posted on • Edited on

How to Scrape TikTok User Profile Data via TokInsight Free API

#tiktok #socialmedia #api #datascience

🚀 Overview

TokInsight is a powerful TikTok API platform that provides comprehensive data insights and original data for TikTok content creators, marketers, and businesses. Our platform offers real-time access to TikTok's vast data ecosystem through a robust REST API. Including :

  • Profile, Device, Video, Music, Comment, Hashtag, Collection(Mix), Trending, Search, Live, Shop, Place, Effect, etc.
  • All apis are mobile versions

📞 Contact

✨ What is the User Profile API?

The User Profile API is one of the core endpoints in the TokInsight platform that allows you to retrieve detailed information about any TikTok user. This includes basic profile information, engagement metrics, follower counts, and other relevant data that can help you understand user behavior and performance.

For example, we can get many information from the following profile page, including unique_id (user_name: eusourenancarneiro), following, followers, likes, bio and contract infomation, etc.

user profile

🛠️ API Endpoint Overview

Step0 Test Proxy

  • GET /test_proxy/: we recommend that you use your own proxy

curl example:

curl --request GET \
    --url https://tokinsight1.p.rapidapi.com/test_proxy/ \
    --header 'x-proxy-server: http://user:pass@host:port' \
    --header 'x-rapidapi-host: tokinsight1.p.rapidapi.com' \
    --header 'x-rapidapi-key: your_rapidapi_key'
Enter fullscreen mode Exit fullscreen mode

replace the 'x-rapidapi-key' and 'x-proxy-server' to your owne.

resp:

{
  "status_code": 200,
  "content": {
    "status": "success",
    "country": "Malaysia",
    "countryCode": "MY",
    "region": "10",
    "regionName": "Selangor",
    "city": "Cyberjaya",
    "zip": "63100",
    "lat": 2.9186,
    "lon": 101.6639,
    "timezone": "Asia/Kuala_Lumpur",
    "isp": "TM TECHNOLOGY SERVICES SDN BHD",
    "org": "Adsl Streamyx",
    "as": "AS4788 TM TECHNOLOGY SERVICES SDN. BHD.",
    "query": "110.**.**.168"
  }
}
Enter fullscreen mode Exit fullscreen mode

Step1: Get uid and sec_uid

  • GET /tok/v1/user_uniqueid/: uid and sec_uid are used widely, it's a basic api

user profile

curl example: eusourenancarneiro

curl --request GET \
    --url 'https://tokinsight1.p.rapidapi.com/tok/v1/user_uniqueid/?unique_id=eusourenancarneiro' \
    --header 'x-proxy-server: http://user:pass@host:port' \
    --header 'x-rapidapi-host: tokinsight1.p.rapidapi.com' \
    --header 'x-rapidapi-key: your_rapidapi_key'
Enter fullscreen mode Exit fullscreen mode

input the parameter unique_id (also called user_name, not the nickname)

resp:

{
  "extra": {
    "fatal_item_ids": [],
    "logid": "202507130115******"
  },
  "log_pb": {
    "impr_id": "202507130115******"
  },
  "sec_uid": "MS4wLjABAAAAXIfkCo1BOpr0hL6wNvfqAjH5QSXA69hggYLUU8yqhHFR_nO0aR_mmxFQ0OI4O8g3",
  "status_code": 0,
  "status_msg": "",
  "uid": "7154462326077277189"
}
Enter fullscreen mode Exit fullscreen mode

So you get the uid and sec_uid with this api.

Step2: Get Profile Detail

  • GET /tok/v1/user_profile/: input uid and get profile details

user profile

example:

curl --request GET \
    --url 'https://tokinsight1.p.rapidapi.com/tok/v1/user_profile/?uid=7154462326077277189' \
    --header 'x-proxy-server: http://user:pass@host:port' \
    --header 'x-rapidapi-host: tokinsight1.p.rapidapi.com' \
    --header 'x-rapidapi-key: your_rapidapi_key'
Enter fullscreen mode Exit fullscreen mode

Input the uid get from the step1.

you can get many data from this resp, including:

  • user account type: Artist
  • user account avatar
  • user post video count: aweme_count
  • follower_count
  • following_count
  • ins_id
  • artist musician info
  • webcast room id
  • share_info: maybe phone, email? ()
  • signature
  • bio link
  • total_favorited
  • twitter_id
  • twitter_name
  • visible_videos_count
  • youtube info
  • seller id
  • etc....

resp:

{
  "extra": {
    "fatal_item_ids": [],
    "logid": "202507130122***************"
  },
  "log_pb": {
    "impr_id": "202507130122***************"
  },
  "status_code": 0,
  "status_msg": "",
  "user": {
    "account_type": 0,
    "ad_virtual": false,
    "avatar_168x168": {
      "uri": "tos-maliva-avt-0068/d6b9fc12a65d0d371f08953d7c9bd149",
      "url_list": [
        "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/d6b9fc12a65d0d371f08953d7c9bd149~tplv-tiktokx-cropcenter:168:168.webp?dr=14577&refresh_token=fccda6c8&x-expires=1752512400&x-signature=iV1SNUqfsVYRFdeakkGD3zQYKY4%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=2472a6c6&idc=maliva",
        "https://p77-sign-va.tiktokcdn.com/tos-maliva-avt-0068/d6b9fc12a65d0d371f08953d7c9bd149~tplv-tiktokx-cropcenter:168:168.webp?dr=14577&refresh_token=250bb2da&x-expires=1752512400&x-signature=%2FFtzzxEh1%2BbFdTSzrKHUspirWpU%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=2472a6c6&idc=maliva",
        "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/d6b9fc12a65d0d371f08953d7c9bd149~tplv-tiktokx-cropcenter:168:168.jpeg?dr=14577&refresh_token=03ccdc60&x-expires=1752512400&x-signature=5XM3aRnKz4JZZVmaXLSOFPCdAqU%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=2472a6c6&idc=maliva"
      ],
      "url_prefix": null
    },
    "avatar_300x300": {
      "uri": "tos-maliva-avt-0068/d6b9fc12a65d0d371f08953d7c9bd149",
      "url_list": [
        "https://p77-sign-va.tiktokcdn.com/tos-maliva-avt-0068/d6b9fc12a65d0d371f08953d7c9bd149~tplv-tiktokx-cropcenter:300:300.webp?dr=14577&refresh_token=d262d5e2&x-expires=1752512400&x-signature=zl6qun%2Bttebhpme50Um0wL9pRok%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=2472a6c6&idc=maliva",
        "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/d6b9fc12a65d0d371f08953d7c9bd149~tplv-tiktokx-cropcenter:300:300.webp?dr=14577&refresh_token=051c87f6&x-expires=1752512400&x-signature=ER%2F99pr5bZ0E99ClHkMdBXndFIc%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=2472a6c6&idc=maliva",
        "https://p77-sign-va.tiktokcdn.com/tos-maliva-avt-0068/d6b9fc12a65d0d371f08953d7c9bd149~tplv-tiktokx-cropcenter:300:300.jpeg?dr=14577&refresh_token=5eafd780&x-expires=1752512400&x-signature=BPx%2B8lMC7Ci4GvOaSoP0v9rqcC4%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=2472a6c6&idc=maliva"
      ],
      "url_prefix": null
    },
    "avatar_larger": {
      "uri": "tos-maliva-avt-0068/d6b9fc12a65d0d371f08953d7c9bd149",
      "url_list": [
        "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/d6b9fc12a65d0d371f08953d7c9bd149~tplv-tiktokx-cropcenter:1080:1080.webp?dr=14579&refresh_token=c441b9ac&x-expires=1752512400&x-signature=4AH8FpQ%2BE87i3pVgdbLzLPMqtdk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=2472a6c6&idc=maliva",
        "https://p77-sign-va.tiktokcdn.com/tos-maliva-avt-0068/d6b9fc12a65d0d371f08953d7c9bd149~tplv-tiktokx-cropcenter:1080:1080.webp?dr=14579&refresh_token=19dfd862&x-expires=1752512400&x-signature=4yDhisuC26CtyDg1ABmA0ei%2Bd7Q%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=2472a6c6&idc=maliva",
        "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/d6b9fc12a65d0d371f08953d7c9bd149~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=a680acd9&x-expires=1752512400&x-signature=qpJw8TS2bDA5B1%2Bek4DhaeL7LSQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=2472a6c6&idc=maliva"
      ],
      "url_prefix": null
    },
    "avatar_medium": {
      "uri": "tos-maliva-avt-0068/d6b9fc12a65d0d371f08953d7c9bd149",
      "url_list": [
        "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/d6b9fc12a65d0d371f08953d7c9bd149~tplv-tiktokx-cropcenter:720:720.webp?dr=14579&refresh_token=03ff720a&x-expires=1752512400&x-signature=ZMCZ7qxnCyt8FtD3cBt%2BKPkTKlQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=2472a6c6&idc=maliva",
        "https://p77-sign-va.tiktokcdn.com/tos-maliva-avt-0068/d6b9fc12a65d0d371f08953d7c9bd149~tplv-tiktokx-cropcenter:720:720.webp?dr=14579&refresh_token=6c06edd6&x-expires=1752512400&x-signature=4Fl20qL7C%2BLZYGR6FG0oTlyG55E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=2472a6c6&idc=maliva",
        "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/d6b9fc12a65d0d371f08953d7c9bd149~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=0cdaf3d7&x-expires=1752512400&x-signature=f8u04qQWdnLTC7k1IYeCH%2FUoIEA%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=2472a6c6&idc=maliva"
      ],
      "url_prefix": null
    },
    "avatar_thumb": {
      "uri": "tos-maliva-avt-0068/d6b9fc12a65d0d371f08953d7c9bd149",
      "url_list": [
        "https://p77-sign-va.tiktokcdn.com/tos-maliva-avt-0068/d6b9fc12a65d0d371f08953d7c9bd149~tplv-tiktokx-cropcenter:100:100.webp?dr=14579&refresh_token=e019b5e4&x-expires=1752512400&x-signature=H7e1Wb6d9drGj3eQXeKc3BnjvQs%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=2472a6c6&idc=maliva",
        "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/d6b9fc12a65d0d371f08953d7c9bd149~tplv-tiktokx-cropcenter:100:100.webp?dr=14579&refresh_token=78ffc11d&x-expires=1752512400&x-signature=QYym6DPIOxNYUfed%2Bnj86kBbGwM%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=2472a6c6&idc=maliva",
        "https://p77-sign-va.tiktokcdn.com/tos-maliva-avt-0068/d6b9fc12a65d0d371f08953d7c9bd149~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=f00a602d&x-expires=1752512400&x-signature=HpR9hFSzvaWy1zoPZ1gJl6zUMPw%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=2472a6c6&idc=maliva"
      ],
      "url_prefix": null
    },
    "aweme_count": 388,
    "category": "",
    "commerce_user_info": {
      "ad_revenue_rits": null
    },
    "commerce_user_level": 0,
    "custom_verify": "",
    "enterprise_verify_reason": "",
    "favoriting_count": 0,
    "follow_status": 0,
    "follower_count": 2814957,
    "follower_status": 0,
    "following_count": 179,
    "forward_count": 0,
    "has_open_favorite": false,
    "ins_id": "",
    "is_acquaintance": false,
    "is_block": false,
    "is_blocked": false,
    "is_effect_artist": false,
    "is_star": false,
    "live_commerce": false,
    "live_push_notification_status": 2,
    "message_chat_entry": false,
    "mplatform_followers_count": 0,
    "music_tab_info": {
      "show_artist_pick_videos": true
    },
    "nickname": "Renan Carneiro",
    "original_musician": {
      "digg_count": 0,
      "music_count": 0,
      "music_used_count": 0,
      "new_release_clip_ids": null
    },
    "privacy_setting": {
      "following_visibility": 2
    },
    "profile_tab_type": 0,
    "recommend_reason_relation": "",
    "room_id": 0,
    "sec_uid": "MS4wLjABAAAAXIfkCo1BOpr0hL6wNvfqAjH5QSXA69hggYLUU8yqhHFR_nO0aR_mmxFQ0OI4O8g3",
    "secret": 0,
    "share_info": {
      "now_invitation_card_image_urls": null,
      "share_desc": "Renan Carneiroをチェックしよう！ #TikTok",
      "share_title": "TikTokに参加して、私が何をしているか見ていって！",
      "share_url": "https://www.tiktok.com/@eusourenancarneiro?_r=1&_d=el9e9g7h1hicd6&sec_uid=MS4wLjABAAAAXIfkCo1BOpr0hL6wNvfqAjH5QSXA69hggYLUU8yqhHFR_nO0aR_mmxFQ0OI4O8g3&share_author_id=7154462326077277189&sharer_language=ja&source=h5_m"
    },
    "short_id": "0",
    "show_favorite_list": false,
    "show_messaging_entrance_on_profile": true,
    "signature": "📧eusourenancarneiro@gmail.com",
    "signature_language": "un",
    "story_status": 0,
    "supporting_ngo": {},
    "tab_settings": {
      "private_tab": {
        "private_tab_style": 1,
        "show_private_tab": false
      },
      "repost_tab": {
        "repost_tab_all_visible": true,
        "show_repost_tab_other": 1
      }
    },
    "total_favorited": 37905160,
    "twitter_id": "",
    "twitter_name": "",
    "uid": "7154462326077277189",
    "unique_id": "eusourenancarneiro",
    "verification_type": 0,
    "visible_videos_count": 388,
    "watch_status": false,
    "with_commerce_enterprise_tab_entry": false,
    "with_commerce_entry": false,
    "with_new_goods": false,
    "youtube_channel_id": "",
    "youtube_channel_title": ""
  }
}
Enter fullscreen mode Exit fullscreen mode

Top comments (0)