API Description

TikTok Works API — Collect works published by a TikTok account or channel.

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

Request URL

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

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.
optionsNoobjectOptional collection settings, described below.

options Parameters

ParameterRequiredTypeDescription
secUidNostringsecUid from the profile; supplying it skips the profile lookup.
cursorNostringContinuation cursor from the previous response. Pass the value unchanged.

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

Each request collects one page. Continue with the returned cursor.

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.
secUidstringsecUid from the profile; supplying it skips the profile lookup.
worksobject[]Collected works.
paginationobjectContinuation cursor and whether more results are available.

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

data.pagination Fields

FieldTypeDescription
cursorstring | nullContinuation cursor from the previous response. Pass the value unchanged.
hasMorebooleanWhether more results are available.

Request Example

curl --request POST \
  --url https://scrapeapi.pangolinfo.com/api/v1/social/tiktok-works \
  --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": 4.0,
  "data": {
    "type": "works",
    "secUid": "MS4wLjABAAAAPZWNdkF_cmVSPCvV0Y6MCsH29mlAOlMOX3ikzGvlfMm3K6OMZv-JrRImpEHxdIMI",
    "works": [
      {
        "workId": "7704861353076346143",
        "parentId": "53279706535428096",
        "type": "video",
        "videoId": "7704861353076346143",
        "url": "https://www.tiktok.com/@scout2015/video/7704861353076346143",
        "desc": "This is really hard😔💔 #dogmom #childhooddog #surgery #recovery ",
        "content": "This is really hard😔💔 #dogmom #childhooddog #surgery #recovery ",
        "createTime": 1793927835,
        "createdISO": "2026-11-06T01:17:15.000Z",
        "publishedAt": 1793927835000,
        "cover": "https://p16-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-tx2/ogEAIIALLEAfDjAAWnI2fUIlx3KzGebEqpqVPt~tplv-tiktokx-origin.image?dr=10395&x-expires=179412480...",
        "playUrl": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/ocyqBdkuBAy1QR9XAIFl7KVDTffQlrSEEEBPtE/?a=1988&bti=ODszNWYuMDE6&&bt=1333&ft=Bich7V...",
        "duration": 10,
        "width": 720,
        "height": 1280,
        "stats": {
          "diggCount": 19,
          "shareCount": 1,
          "commentCount": 2,
          "playCount": 407,
          "collectCount": 1,
          "repostCount": 0
        },
        "isPinned": false,
        "isAd": false,
        "hashtags": [
          "dogmom"
        ],
        "music": {
          "id": "7684150368565250075",
          "title": "Paper Moon Static",
          "authorName": "Marnie Cusk"
        }
      }
    ],
    "pagination": {
      "cursor": "1793547411238",
      "hasMore": true
    }
  },
  "meta": {
    "requestId": "pg-audit-r1-tiktok-works-1793954375877083400",
    "durationMs": 16864
  },
  "billing": {
    "unitPrice": 0.8,
    "ruleVersion": "social-primary-v2",
    "billedCount": 5,
    "pointCost": 4.0
  }
}

Points Usage

0.8 points per primary result.

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