API Description

TikTok Home API — Collect TikTok profile information and first-page works.

Authenticate with your Pangolinfo API Key to receive structured JSON data.

Request URL

POST https://scrapeapi.pangolinfo.com/api/v1/social/tiktok-home

Request Headers

ParametersParameter valueTypeDescription
Content-Typeapplication/jsonstringData format
AuthorizationBearer xxxstringAuthorization Token

Collection takes up to approximately 75 seconds. Set your client timeout to 90 seconds.

Request Parameters

ParameterRequiredTypeDescription
targetYesstringTarget URL, supported ID or search keyword for this operation.

Only the request parameters listed on this page are used; other fields are ignored. Pass pagination cursors back unchanged, without encoding, decoding or conversion.

Includes first-page works. Use the works operation, where available, to continue.

Response Fields

FieldTypeDescription
codeintegerStatus code; 0 indicates success.
messagestringResponse message; ok on success.
pointCostnumberPoints charged for this request.
dataobjectCollected data, with fields described below.
metaobjectRequest identifier and duration in milliseconds.
billingobjectCharged units, unit price and billing rule version.

data Fields

FieldTypeDescription
typestringResult type.
profileobjectProfile details.
worksobject[]Collected works.

data.profile Fields

FieldTypeDescription
accountIdstring | nullAccount id
userIdstring | nullUser id
secUidstring | nullsecUid from the profile; supplying it skips the profile lookup.
usernamestringUsername
handlestringHandle
nicknamestring | nullAuthor display name.
namestringName
profileUrlstringAuthor profile URL.
avatarstring | nullAvatar URL.
avatar_urlstring | nullAvatar url
profile_pic_urlstring | nullProfile pic url
avatarThumbstring | nullAvatar thumb
verifiedbooleanVerified
isVerifiedbooleanIs verified
is_verifiedbooleanIs verified
isPrivatebooleanIs private
is_privatebooleanIs private
regionstring | nullRegion
countrystring | nullCountry
biostring | nullBio
biographystring | nullBiography
descriptionstring | nullDescription
signaturestring | nullSignature
contactEmailstring | nullContact email
externalLinksstring[]External links
externalUrlsstring[]External urls
languagestring | nullSelected subtitle language.
registerTimeobject | nullRegister time
createdAtstring | nullCreated at
createdTimenumber | nullCreated time
followersCountnumber | nullFollowers count
follower_countnumber | nullFollower count
followerCountnumber | nullFollower count
followingCountnumber | nullFollowing count
following_countnumber | nullFollowing count
likesCountnumber | nullLikes count
heartCountnumber | nullHeart count
videosCountnumber | nullVideos count
videoCountnumber | nullVideo count
diggCountnumber | nullDigg count
friendCountnumber | nullFriend count
bioLinksobject[]Bio links
isOrganizationbooleanIs organization
ttSellerbooleanTt seller
commerceCategorystring | nullCommerce category
openFavoritebooleanOpen favorite
followingVisibilitynumber | nullFollowing visibility
commentSettingnumber | nullComment setting
duetSettingnumber | nullDuet setting
stitchSettingnumber | nullStitch setting
downloadSettingnumber | nullDownload setting
roomIdstring | nullRoom id
nickNameModifyTimenumber | nullNick name modify time
uniqueIdModifyTimenumber | nullUnique id modify time
shareTitlestring | nullShare title
shareDescstring | nullShare desc
targetUrlstringTarget url

data.profile.registerTime Fields

FieldTypeDescription
timestampnumberTimestamp
isostring | nullIso

data.profile.bioLinks[] Fields

FieldTypeDescription
linkstringLink
risknumber | nullRisk

data.works[] Fields

FieldTypeDescription
workIdstringWork id
parentIdstringParent post or comment identifier.
typestringResult type.
videoIdstringVideo id
urlstringContent URL.
descstring | nullDesc
contentstring | nullContent text; may be null for records without text.
createTimenumber | nullCreate time
createdISOstring | nullCreated iso
publishedAtnumber | nullPublication time.
coverstring | nullCover
playUrlstring | nullPlay url
durationnumber | nullDuration
widthnumber | nullWidth
heightnumber | nullHeight
statsobjectStats
isPinnedbooleanIs pinned
isAdbooleanIs ad
hashtagsstring[]Hashtags
musicobject | nullMusic

data.works[].stats Fields

FieldTypeDescription
diggCountnumber | nullDigg count
shareCountnumber | nullShare count
commentCountnumber | nullComment count
playCountnumber | nullPlay count
collectCountnumber | nullCollect count
repostCountnumber | nullRepost count

data.works[].music Fields

FieldTypeDescription
idstringRecord identifier.
titlestring | nullTitle
authorNamestring | nullAuthor name

Request Example

curl --request POST \
  --url https://scrapeapi.pangolinfo.com/api/v1/social/tiktok-home \
  --header 'Authorization: Bearer YOUR_PANGOLINFO_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "target": "https://www.tiktok.com/@scout2015"
}'

Response Example

This excerpt shows the first item of each list. Long text and URLs are shortened; pointCost is the charge for the complete response. The playground contains the full schema.

{
  "code": 0,
  "message": "ok",
  "pointCost": 0.8,
  "data": {
    "type": "home",
    "profile": {
      "accountId": "53279706535428096",
      "userId": "53279706535428096",
      "secUid": "MS4wLjABAAAAPZWNdkF_cmVSPCvV0Y6MCsH29mlAOlMOX3ikzGvlfMm3K6OMZv-JrRImpEHxdIMI",
      "username": "scout2015",
      "handle": "@scout2015",
      "nickname": "Scout, Suki & Stella",
      "name": "Scout, Suki & Stella",
      "profileUrl": "https://www.tiktok.com/@scout2015",
      "avatar": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/4cbe05e194623e3f19aef975d9fdf26c~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=8e9c...",
      "avatar_url": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/4cbe05e194623e3f19aef975d9fdf26c~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=8e9c...",
      "profile_pic_url": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/4cbe05e194623e3f19aef975d9fdf26c~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=8e9c...",
      "avatarThumb": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/4cbe05e194623e3f19aef975d9fdf26c~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=3518ba...",
      "verified": true,
      "isVerified": true,
      "is_verified": true,
      "isPrivate": false,
      "is_private": false,
      "region": null,
      "country": null,
      "bio": "🐾Click follow to join the PAWsitive Pack🐾\nMore👇💞",
      "biography": "🐾Click follow to join the PAWsitive Pack🐾\nMore👇💞",
      "description": "🐾Click follow to join the PAWsitive Pack🐾\nMore👇💞",
      "signature": "🐾Click follow to join the PAWsitive Pack🐾\nMore👇💞",
      "contactEmail": null,
      "externalLinks": [],
      "externalUrls": [],
      "language": "en",
      "registerTime": {
        "timestamp": 1453074387,
        "iso": "2016-01-17T23:46:27.000Z"
      },
      "createdAt": "2016-01-17T23:46:27.000Z",
      "createdTime": 1453074387,
      "followersCount": 9025921,
      "follower_count": 9025921,
      "followerCount": 9025921,
      "followingCount": 1174,
      "following_count": 1174,
      "likesCount": 108347824,
      "heartCount": 108347824,
      "videosCount": 3086,
      "videoCount": 3086,
      "diggCount": 0,
      "friendCount": 672,
      "bioLinks": [
        {
          "link": "Scout2015.com",
          "risk": 3
        }
      ],
      "isOrganization": false,
      "ttSeller": false,
      "commerceCategory": null,
      "openFavorite": false,
      "followingVisibility": 2,
      "commentSetting": 0,
      "duetSetting": 0,
      "stitchSetting": 0,
      "downloadSetting": 3,
      "roomId": null,
      "nickNameModifyTime": 1630843696,
      "uniqueIdModifyTime": null,
      "shareTitle": "Scout, Suki & Stella on TikTok",
      "shareDesc": "@scout2015 9.0m Followers, 1174 Following, 108.3m Likes - Watch awesome short videos created by Scout, Suki & Stella",
      "targetUrl": "https://www.tiktok.com/@scout2015"
    },
    "works": []
  },
  "meta": {
    "requestId": "pg-audit-r1-tiktok-home-1793954349104852500",
    "durationMs": 21837
  },
  "billing": {
    "unitPrice": 0.8,
    "ruleVersion": "social-primary-v2",
    "billedCount": 1,
    "pointCost": 0.8
  }
}

Points Usage

0.8 points per profile. Included works are free.

Empty results and failed requests are not charged. Duplicate IDs are counted once within a response. Separate calls and pages are billed separately. See Social Media Reviews API billing.

Try it