TikTok API endpoint

Retrieve posts from a TikTok profile

Returns posts from a TikTok profile by `secUid`, with optional cursor pagination and sort mode.

GETapiKey8 credits/requesttiktok.profilePostResponseDoc/tiktok/posts

Parameters

Name	In	Type	Required	Enum	Example	Description
x-api-key	header	string	Yes			API key required
secUid	query	string	Yes		MS4wLjABAAAAT4vq3vsh9X-Vb_WtV6tz4QWTbKjliTKCiK5DqnJNtQEA2RUveHb7UdnL7xgPK2HB	TikTok secUid for the profile
cursor	query	integer	No			Pagination cursor
sort_type	query	integer	No	0, 1, 2		Sort mode: 0 latest, 1 popular, 2 oldest

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

Response behavior

- Pass the returned `cursor` value from a previous response to continue pagination. Example response: ```json { "code": 200, "msg": "OK", "data": { "cursor": "1728674650000", "extra": { "fatal_item_ids": [], "logid": "2024121114064544C2FAFFE7F9650789D4", "now": 1733926005000 }, "hasMore": true, "itemList": [ { "AIGCDescription": "", "CategoryType": 120, "author": { "avatarLarger": "https://p19-pu-sign-useast8.tiktokcdn-us.com/tos-useast5-avt-0068-tx/fb1ed871dc01261013179da3fafcc1cd~c5_1080x1080.jpeg?lk3s=a5d48078&non...", "avatarMedium": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast5-avt-0068-tx/fb1ed871dc01261013179da3fafcc1cd~c5_720x720.jpeg?lk3s=a5d48078&nonce...", "avatarThumb": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast5-avt-0068-tx/fb1ed871dc01261013179da3fafcc1cd~c5_100x100.jpeg?lk3s=a5d48078&nonce...", "commentSetting": 0, "downloadSetting": 0, "duetSetting": 0 }, "authorStats": { "diggCount": 352, "followerCount": 458800, "followingCount": 1, "friendCount": 0, "heart": 800300, "heartCount": 800300 }, "backendSourceEventTracking": "", "challenges": [ { "coverLarger": "", "coverMedium": "", "coverThumb": "", "desc": "", "id": "7172185891421552645", "profileLarger": "" } ] } ], "log_pb": { "impr_id": "2024121114064544C2FAFFE7F9650789D4" }, "status_code": 0 } } ```

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": {
    "cursor": "1728674650000",
    "extra": {
      "fatal_item_ids": [],
      "logid": "2024121114064544C2FAFFE7F9650789D4",
      "now": 1733926005000
    },
    "hasMore": true,
    "itemList": [
      {
        "AIGCDescription": "",
        "CategoryType": 120,
        "author": {
          "avatarLarger": "https://p19-pu-sign-useast8.tiktokcdn-us.com/tos-useast5-avt-0068-tx/fb1ed871dc01261013179da3fafcc1cd~c5_1080x1080.jpeg?lk3s=a5d48078&non...",
          "avatarMedium": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast5-avt-0068-tx/fb1ed871dc01261013179da3fafcc1cd~c5_720x720.jpeg?lk3s=a5d48078&nonce...",
          "avatarThumb": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast5-avt-0068-tx/fb1ed871dc01261013179da3fafcc1cd~c5_100x100.jpeg?lk3s=a5d48078&nonce...",
          "commentSetting": 0,
          "downloadSetting": 0,
          "duetSetting": 0
        },
        "authorStats": {
          "diggCount": 352,
          "followerCount": 458800,
          "followingCount": 1,
          "friendCount": 0,
          "heart": 800300,
          "heartCount": 800300
        },
        "backendSourceEventTracking": "",
        "challenges": [
          {
            "coverLarger": "",
            "coverMedium": "",
            "coverThumb": "",
            "desc": "",
            "id": "7172185891421552645",
            "profileLarger": ""
          }
        ]
      }
    ],
    "log_pb": {
      "impr_id": "2024121114064544C2FAFFE7F9650789D4"
    },
    "status_code": 0
  }
}

Request schema

No body schema

Response schema

#/definitions/tiktok.profilePostResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	tiktok.UserPostLinkResp	No
data.cursor	string	No
data.extra	object	No
data.extra.fatal_item_ids	array	No
data.extra.logid	string	No
data.extra.now	integer	No
data.hasMore	boolean	No
data.itemList	array	No
data.log_pb	object	No
data.log_pb.impr_id	string	No
data.status_code	integer	No
data.status_msg	string	No
msg	string	No	OK

Example request

curl -X GET "https://api.crawlora.net/api/v1/tiktok/posts?secUid=MS4wLjABAAAAT4vq3vsh9X-Vb_WtV6tz4QWTbKjliTKCiK5DqnJNtQEA2RUveHb7UdnL7xgPK2HB" -H "x-api-key: <api-key>"

TypeScript fetch

const url = new URL("https://api.crawlora.net/api/v1/tiktok/posts");
url.searchParams.set("secUid", "MS4wLjABAAAAT4vq3vsh9X-Vb_WtV6tz4QWTbKjliTKCiK5DqnJNtQEA2RUveHb7UdnL7xgPK2HB");
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