Logo SearchApi

TikTok Profile API Documentation

GET   /api/v1/search?engine=tiktok_profile

The TikTok Profile API provides detailed information about TikTok user profiles, including user statistics, verification status, bio, avatar, follower counts, and other profile metadata.

API Parameters

Search Query

  • Name
    handle
    Required
    Required
    Description

    Parameter defines the TikTok handle or ID you want to retrieve profile information for. You can use the handle with or without the @ symbol, or use the numeric TikTok ID directly.
    For example, @therock, therock, @6745191554350760966, and 6745191554350760966 will all retrieve the same profile.

Engine

  • Name
    engine
    Required
    Required
    Description

    Parameter defines an engine that will be used to retrieve real-time data. It must be set to tiktok_profile.

API key

  • Name
    api_key
    Required
    Required
    Description

    The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

Zero Data Retention

  • Name
    zero_retention
    Enterprise Only
    Enterprise Only
    Required
    Optional
    Description

    Set this parameter to true to disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.

API Examples

Full Response

Full Response
GET
https://www.searchapi.io/api/v1/search?engine=tiktok_profile&handle=therock
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "tiktok_profile",
  "handle": "therock"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_YzO8NlMJg5M9U4B8gnBvQxXR",
    "status": "Success",
    "created_at": "2025-10-07T13:36:24Z",
    "request_time_taken": 1.65,
    "parsing_time_taken": 0.01,
    "total_time_taken": 1.66,
    "request_url": "https://www.tiktok.com/@therock",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_YzO8NlMJg5M9U4B8gnBvQxXR.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_YzO8NlMJg5M9U4B8gnBvQxXR"
  },
  "search_parameters": {
    "engine": "tiktok_profile",
    "handle": "therock"
  },
  "profile": {
    "id": "6745191554350760966",
    "handle": "therock",
    "nickname": "The Rock",
    "description": "CEO of #RockTok\nLife's so much sweeter when you're not an asshole",
    "avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/7310325298631802885~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=902b24b1&x-expires=1760014800&x-signature=x5X8UEvgcTKzBkCi0m5J6FwO3Mo%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=b59d6b55&idc=useast5",
    "avatar_medium": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/7310325298631802885~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&refresh_token=67bf7c32&x-expires=1760014800&x-signature=GkeVf0OjMW90Ykc0tFKQcmUzMrI%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=b59d6b55&idc=useast5",
    "avatar_thumb": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/7310325298631802885~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&refresh_token=3367ba8e&x-expires=1760014800&x-signature=RQtjWrQV9QH74OdVBHbDhaymgYw%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
    "is_verified": true,
    "relation": 0,
    "comment_setting": 0,
    "duet_setting": 0,
    "stitch_setting": 0,
    "download_setting": 0,
    "following_visibility": 1,
    "profile_embed_permission": 1,
    "bio_link": {
      "url": "therock.komi.io",
      "risk_level": 3
    },
    "created_at": 1570487607,
    "created_at_iso": "2019-10-07T22:33:27Z",
    "sec_uid": "MS4wLjABAAAAM3R2BtjzVT-uAtstkl2iugMzC6AtnpkojJbjiOdDDrdsTiTR75-8lyWJCY5VvDrZ",
    "unique_id_modify_time": 0,
    "title_modify_time": 0,
    "commerce_user_info": {
      "commerce_user": false
    },
    "language": "en",
    "can_exp_playlist": true,
    "profile_tab": {
      "show_music_tab": false,
      "show_question_tab": false,
      "show_play_list_tab": true
    },
    "is_organization": 0,
    "user_story_status": 0
  },
  "stats": {
    "followers": 80200000,
    "following": 0,
    "hearts": 651400000,
    "videos": 450,
    "likes": 0,
    "friends": 0
  }
}