TikTok Search API
Search TikTok content by keyword and return matching results.
API Description
TikTok Search API — Search TikTok content by keyword and return matching results.
Authenticate with your Pangolinfo API Key to receive structured JSON data.
Request URL
Request Headers
| Parameters | Parameter value | Type | Description |
|---|---|---|---|
| Content-Type | application/json | string | Data format |
| Authorization | Bearer xxx | string | Authorization Token |
Collection takes up to approximately 75 seconds. Set your client timeout to 90 seconds.
Request Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
| target | Yes | string | Target URL, supported ID or search keyword for this operation. |
| options | No | object | Optional collection settings, described below. |
options Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
| maxPages | No | integer | Pages to collect. Default: 1; values above 5 are capped at 5. Must be a positive integer. Default: 1 Minimum: 1 Maximum: 5 |
| type | No | string | Search result type. Values: [“video”, “user”] |
| cursor | No | string | Continuation 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.
One page by default, capped at five per request. Page counts must be positive integers; higher values are capped at five.
Response Fields
| Field | Type | Description |
|---|---|---|
| code | integer | Status code; 0 indicates success. |
| message | string | Response message; ok on success. |
| pointCost | number | Points charged for this request. |
| data | object | Collected data, with fields described below. |
| meta | object | Request identifier and duration in milliseconds. |
| billing | object | Charged units, unit price and billing rule version. |
data Fields
| Field | Type | Description |
|---|---|---|
| videos | object[] | Videos |
| users | object[] | Users |
| count | number | Number of result items. |
| pagination | object | Continuation cursor and whether more results are available. |
data.videos[] Fields
| Field | Type | Description |
|---|---|---|
| workId | string | Work id |
| parentId | string | Parent post or comment identifier. |
| type | string | Result type. |
| videoId | string | Video id |
| url | string | Content URL. |
| desc | string | null | Desc |
| content | string | null | Content text; may be null for records without text. |
| createTime | number | null | Create time |
| createdISO | string | null | Created iso |
| publishedAt | number | null | Publication time. |
| cover | string | null | Cover |
| playUrl | string | null | Play url |
| duration | number | null | Duration |
| width | number | null | Width |
| height | number | null | Height |
| stats | object | Stats |
| isPinned | boolean | Is pinned |
| isAd | boolean | Is ad |
| hashtags | string[] | Hashtags |
| music | object | null | Music |
| author | object | Author |
data.videos[].stats Fields
| Field | Type | Description |
|---|---|---|
| diggCount | number | null | Digg count |
| shareCount | number | null | Share count |
| commentCount | number | null | Comment count |
| playCount | number | null | Play count |
| collectCount | number | null | Collect count |
| repostCount | number | null | Repost count |
data.videos[].music Fields
| Field | Type | Description |
|---|---|---|
| id | string | Record identifier. |
| title | string | null | Title |
| authorName | string | null | Author name |
data.videos[].author Fields
| Field | Type | Description |
|---|---|---|
| id | string | null | Record identifier. |
| uniqueId | string | null | Unique id |
| nickname | string | null | Author display name. |
| secUid | string | null | secUid from the profile; supplying it skips the profile lookup. |
| avatar | string | null | Avatar URL. |
| verified | boolean | Verified |
| privateAccount | boolean | Private account |
| profileUrl | string | null | Author profile URL. |
data.users[] Fields
| Field | Type | Description |
|---|---|---|
| userId | string | User id |
| secUid | string | null | secUid from the profile; supplying it skips the profile lookup. |
| username | string | null | Username |
| nickname | string | null | Author display name. |
| signature | string | null | Signature |
| avatar | string | null | Avatar URL. |
| profileUrl | string | null | Author profile URL. |
| followersCount | number | null | Followers count |
| likesCount | number | null | Likes count |
| verifyReason | string | null | Verify reason |
data.pagination Fields
| Field | Type | Description |
|---|---|---|
| cursor | string | null | Continuation cursor from the previous response. Pass the value unchanged. |
| hasMore | boolean | Whether more results are available. |
Request Example
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.
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.

