API Documentation

TikTok User Profile API

Query public TikTok data synchronously; empty results and failures are free.

Test API

Results return directly in the same request; no task submission or polling is needed.

Open product page and API Tester

Endpoint and authentication

GET https://api.goanyapi.com/api/v1/tiktok/user-profile

Authenticate with Authorization: Bearer YOUR_API_KEY. Supply query-string parameters; there is no request body.

Input parameters

ParameterTypeLocationRequiredConstraints / defaultDescription
AuthorizationstringHeaderYesBearer YOUR_API_KEYAPI key for the current account
usernamestringQueryOne of two^[A-Za-z0-9._]+$Username. Example: spidey.glow. Supply the username without @.
urlstringQueryOne of two^https://(www\.)?tiktok\.com/@[A-Za-z0-9._]+/?(?:\?[^#\s]*)?(?:#[^\s]*)?$Full TikTok profile URL. Example: https://www.tiktok.com/@spidey.glow. Supply either url or username, never both. Sharing parameters and fragments are removed. Short links are unsupported. URL resolution adds no separate credit charge.

Full URL supported: https://www.tiktok.com/@spidey.glow. Supply either url or username, never both. Sharing parameters, fragments and trailing slashes are removed; short links are unsupported. URL format handling adds no separate charge.

Request example

GET /api/v1/tiktok/user-profile?url=https%3A%2F%2Fwww.tiktok.com%2F%40spidey.glow
Authorization: Bearer YOUR_API_KEY

Output parameters

Success returns HTTP 200. Null, empty and missing business fields are preserved; a zero statistic is valid. Only documented public fields are returned.

FieldTypeDescription
codestringok on success
messagestringRequest message
data.creditsUsednumberCredits charged for this request; zero for empty results
data.remainingCreditsnumberAccount balance after settlement
data.userobject | nullProfile object; null when empty
data.statsobject | nullStatistics
data.statsV2object | nullLarge statistics may use strings; values are preserved
data.user.idstring | number | boolean | nullPublic profile field; may be absent or empty
data.user.uniqueIdstring | number | boolean | nullPublic profile field; may be absent or empty
data.user.nicknamestring | number | boolean | nullPublic profile field; may be absent or empty
data.user.signaturestring | number | boolean | nullPublic profile field; may be absent or empty
data.user.secUidstring | number | boolean | nullAccount identifier; query user posts directly with a profile URL or username without first retrieving this value
data.user.avatarThumbstring | number | boolean | nullPublic profile field; may be absent or empty
data.user.avatarMediumstring | number | boolean | nullPublic profile field; may be absent or empty
data.user.avatarLargerstring | number | boolean | nullPublic profile field; may be absent or empty
data.user.verifiedstring | number | boolean | nullPublic profile field; may be absent or empty
data.user.privateAccountstring | number | boolean | nullPublic profile field; may be absent or empty
data.user.createTimestring | number | boolean | nullPublic profile field; may be absent or empty
data.stats.diggCountnumber | string | nullReturned statistic; may be absent or empty
data.stats.shareCountnumber | string | nullReturned statistic; may be absent or empty
data.stats.commentCountnumber | string | nullReturned statistic; may be absent or empty
data.stats.playCountnumber | string | nullReturned statistic; may be absent or empty
data.stats.collectCountnumber | string | nullReturned statistic; may be absent or empty
data.stats.followerCountnumber | string | nullReturned statistic; may be absent or empty
data.stats.followingCountnumber | string | nullReturned statistic; may be absent or empty
data.stats.heartCountnumber | string | nullReturned statistic; may be absent or empty
data.stats.heartnumber | string | nullReturned statistic; may be absent or empty
data.stats.videoCountnumber | string | nullReturned statistic; may be absent or empty
data.stats.friendCountnumber | string | nullReturned statistic; may be absent or empty
data.stats.viewCountnumber | string | nullReturned statistic; may be absent or empty
data.statsV2.diggCountnumber | string | nullReturned statistic; may be absent or empty
data.statsV2.shareCountnumber | string | nullReturned statistic; may be absent or empty
data.statsV2.commentCountnumber | string | nullReturned statistic; may be absent or empty
data.statsV2.playCountnumber | string | nullReturned statistic; may be absent or empty
data.statsV2.collectCountnumber | string | nullReturned statistic; may be absent or empty
data.statsV2.followerCountnumber | string | nullReturned statistic; may be absent or empty
data.statsV2.followingCountnumber | string | nullReturned statistic; may be absent or empty
data.statsV2.heartCountnumber | string | nullReturned statistic; may be absent or empty
data.statsV2.heartnumber | string | nullReturned statistic; may be absent or empty
data.statsV2.videoCountnumber | string | nullReturned statistic; may be absent or empty
data.statsV2.friendCountnumber | string | nullReturned statistic; may be absent or empty
data.statsV2.viewCountnumber | string | nullReturned statistic; may be absent or empty

Real response example

Saved from a real successful response and projected to public fields. Lists show only the first two records. Account balance and request charges are omitted; live responses also contain creditsUsed and remainingCredits based on current configuration. Displaying the example sends no query and charges no credits.

{
  "code": "ok",
  "message": "ok",
  "data": {
    "user": {
      "id": "7672400417817625622",
      "uniqueId": "spidey.glow",
      "nickname": "SpideyGlow",
      "signature": "",
      "secUid": "MS4wLjABAAAAK4RIcIbr3DY__BALfxpDu7FXrXMdNIkck5Zzt7ScvdWxtGgRjeLDOCixGr4nFQrG",
      "avatarThumb": "https://p19-common-sign.tiktokcdn-us.com/tos-useast2a-avt-0068-euttp/58cb4b19080af86926f621f3ced3a91d~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&refresh_token=4babe6a8&x-expires=1794646800&x-signature=L1xXQL6lgzSEukL%2FUee7vsdWmGY%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
      "avatarMedium": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-avt-0068-euttp/58cb4b19080af86926f621f3ced3a91d~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&refresh_token=18965771&x-expires=1794646800&x-signature=k%2FtqwEg%2FG2ewpHJw%2FxdKOhdeRm0%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
      "avatarLarger": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-avt-0068-euttp/58cb4b19080af86926f621f3ced3a91d~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=77a532ec&x-expires=1794646800&x-signature=VNupCvmJLvBS4NlYIIyGjijt9gw%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
      "verified": false,
      "privateAccount": false,
      "createTime": 1786369984
    },
    "stats": {
      "diggCount": 0,
      "followerCount": 2581,
      "followingCount": 0,
      "heartCount": 25500,
      "heart": 25500,
      "videoCount": 43,
      "friendCount": 0
    },
    "statsV2": {
      "diggCount": "0",
      "followerCount": "2581",
      "followingCount": "0",
      "heartCount": "25455",
      "heart": "25455",
      "videoCount": "43",
      "friendCount": "0"
    }
  }
}

Billing

With the current configuration, each successful request costs 1 credit.

Non-empty successful results use the currently configured rate; empty results and failures are free. Sufficient balance is required before requesting. A concurrent settlement with insufficient balance also returns 402 without delivering unsettled paid results. Empty or null details and lists without meaningful records are empty; individual empty fields do not make a populated result empty.

Errors

400: invalid parameters; 401: invalid authentication; 402: insufficient credits; 429: rate limit; 502: request failed; 503: API or pricing not configured. Errors contain code and message without internal addresses or credentials.

{"code":"invalid_params","message":"Invalid parameter"}