TikTok API endpoint

Retrieve a TikTok profile

Returns the TikTok profile payload for a public handle.

GETapiKey8 credits/requesttiktok.profileResponseDoc/tiktok/profile/{handler}

Parameters

Name	In	Type	Required	Enum	Example	Description
x-api-key	header	string	Yes			API key required
handler	path	string	Yes		chatgpt	TikTok handle without the leading @

Authentication

Send your scraping API key in the x-api-key header. Use the console API Keys page to rotate or select the active key.

Billing

Endpoint usage is metered in credits. The plan prices, included credits, limits, and overage rates below match the active backend billing configuration.

Credit cost: 8 credits/request
Charged response: Successful 2xx responses

Plan	Price	Included credits	Daily cap	Rate limit	Overage
Free	$0/mo	2,000	500 daily credits	5/min	No overage
Starter	$9/mo	20,000	5,000 daily credits	15/min	$0.75/1,000 overage credits when enabled
Growth	$29/mo	100,000	25,000 daily credits	45/min	$0.45/1,000 overage credits when enabled
Pro	$79/mo	400,000	No daily cap	120/min	$0.30/1,000 overage credits
Business	$199/mo	1,200,000	No daily cap	300/min	$0.20/1,000 overage credits
Enterprise	$499/mo	5,000,000	No daily cap	1,000/min	$0.12/1,000 overage credits

Failure responses

Status	Description	Schema
400	Invalid input	#/definitions/app.Response
429	Rate limit exceeded	#/definitions/app.Response
500	Internal server error	#/definitions/app.Response

Example response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "user": {
      "id": "7256182609359995947",
      "uniqueId": "chatgpt",
      "nickname": "chatgpt",
      "signature": "What can I help with?",
      "verified": true,
      "secUid": "MS4wLjABAAAAT4vq3vsh9X-Vb_WtV6tz4QWTbKjliTKCiK5DqnJNtQEA2RUveHb7UdnL7xgPK2HB"
    },
    "stats": {
      "followerCount": 458800,
      "followingCount": 1,
      "heartCount": 800300,
      "videoCount": 59
    }
  }
}

Request schema

No body schema

Response schema

#/definitions/tiktok.profileResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	tiktok.Profile	No
data.stats	tiktok.ProfileStats	No
data.stats.diggCount	integer	No	0
data.stats.followerCount	integer	No	458800
data.stats.followingCount	integer	No	1
data.stats.friendCount	integer	No	1
data.stats.heart	integer	No	800300
data.stats.heartCount	integer	No	800300
data.stats.videoCount	integer	No	59
data.user	tiktok.User	No
data.user.avatarLarger	string	No	https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast5-avt-0068-tx/fb1ed871dc01261013179da3fafcc1cd~c5_1080x1080.jpeg?lk3s=a5d48078&nonce=62362&refresh_token=e3e8e01eff1ea0116ae406af630dc407&x-expires=1734098400&x-signature=MXMzwWT8Tl1nxFZfYNQxOZM%2F%2Byo%3D&shp=a5d48078&shcp=81f88b70
data.user.bioLink	object	No
data.user.bioLink.link	string	No	www.openai.com/chatgpt
data.user.commerceUserInfo	object	No
data.user.commerceUserInfo.category	string	No	Software & Apps
data.user.commerceUserInfo.commerceUser	boolean	No	true
data.user.createTime	integer	No	1689461786
data.user.id	string	No	7256182609359995947
data.user.isOrganization	integer	No	1
data.user.language	string	No	en
data.user.nickname	string	No	chatgpt
data.user.privateAccount	boolean	No	false
data.user.region	string	No	US
data.user.secUid	string	No	MS4wLjABAAAAT4vq3vsh9X-Vb_WtV6tz4QWTbKjliTKCiK5DqnJNtQEA2RUveHb7UdnL7xgPK2HB
data.user.secret	boolean	No	false
data.user.signature	string	No	What can I help with?
data.user.ttSeller	boolean	No	false
data.user.uniqueId	string	No	uniqueId
data.user.verified	boolean	No	true
msg	string	No	OK

Example request

curl -X GET "https://api.crawlora.net/api/v1/tiktok/profile/chatgpt" -H "x-api-key: <api-key>"

TypeScript fetch

const url = new URL("https://api.crawlora.net/api/v1/tiktok/profile/chatgpt");
const headers = new Headers();
headers.set("x-api-key", "<api-key>");
const response = await fetch(url, {
  method: "GET",
  headers,
});
const payload = await response.json();

Open in Playground Back to group