Profile

GET/v1/tiktok/profile1 credit

Returns the public profile of a TikTok account: user details (name, bio, avatar, verification, bio link) and its follower, following, like and video counts.

01Query parameters

Name	Type	Description
handleoptional	string	The account's username, with or without `@`, or its profile URL. One of `handle` or `user_id` is required; when both are given, `handle` is used.
user_idoptional	string	The account's numeric user id. One of `handle` or `user_id` is required.
cache_max_ageoptional	string	Accepted for compatibility; every call is fetched fresh. Any other value is rejected with a free 400.Accepted values:`1d3d7d14d30d`

02Request

curl "https://api.scrapesocial.ai/v1/tiktok/profile?handle=tiktok" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/tiktok/profile?handle=tiktok

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "user": {
    "id": "107955",
    "shortId": "",
    "uniqueId": "tiktok",
    "nickname": "TikTok",
    "avatarLarger": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=995fbd26&x-expires=1793120400&x-signature=4Uln2LWthKdh0Hwbyegf4%2Fc6CXs%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my",
    "avatarMedium": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=bed6c8d0&x-expires=1793120400&x-signature=o7l8LcJLbNVmSGhfKlst0Rp06jw%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my",
    "avatarThumb": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=ca99aabf&x-expires=1793120400&x-signature=rfQn4YeRDcDxqRptCEDm1QguoPo%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my",
    "signature": "Your next discovery is waiting on TikTok.",
    "createTime": 1425144149,
    "verified": true,
    "secUid": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM",
    "ftc": false,
    "relation": 0,
    "openFavorite": false,
    "bioLink": {
      "link": "tiktok.com/discovermore",
      "risk": 0
    },
    "commentSetting": 0,
    "commerceUserInfo": {
      "commerceUser": true,
      "downLoadLink": {
        "android": "",
        "ios": ""
      },
      "category": "Others",
      "categoryButton": false
    },
    "duetSetting": 0,
    "stitchSetting": 0,
    "privateAccount": false,
    "secret": false,
    "isADVirtual": false,
    "roomId": "",
    "uniqueIdModifyTime": 0,
    "ttSeller": false,
    "downloadSetting": 0,
    "profileTab": {
      "showMusicTab": true,
      "showQuestionTab": true,
      "showPlayListTab": true
    },
    "followingVisibility": 1,
    "recommendReason": "",
    "nowInvitationCardUrl": "",
    "nickNameModifyTime": 1638559600,
    "isEmbedBanned": false,
    "canExpPlaylist": true,
    "profileEmbedPermission": 1,
    "language": "en",
    "eventList": [],
    "suggestAccountBind": false,
    "isOrganization": 1,
    "UserStoryStatus": 0,
    "shortDramaCreator": {}
  },
  "stats": {
    "followerCount": 96400000,
    "followingCount": 1,
    "heart": 466100000,
    "heartCount": 466100000,
    "videoCount": 1514,
    "diggCount": 0,
    "friendCount": 1
  },
  "statsV2": {
    "followerCount": "96441334",
    "followingCount": "1",
    "heart": "466090159",
    "heartCount": "466090159",
    "videoCount": "1514",
    "diggCount": "0",
    "friendCount": "1"
  },
  "itemList": []
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

The answer has `user`, `stats` and `statsV2` (the same counts as strings); `itemList` is always empty, so use the Profile Videos endpoint for posts. An unknown handle or user id answers 404 with `account_deactivated: true`, free of charge.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.