Developer docs / Publishing tasks
List publishing records
List paginated TikTok and TikTok Shop publishing records to track status and read platform post IDs, failure reasons, media, product, and scheduling details.
GET
/v1/creator/post/pageList- Authentication:
- Request header x-api-key: <YOUR_API_KEY>; keep the key on the server and never expose it in client code, logs or shared files.
- Success criteria:
- HTTP 2xx with code=0; for asynchronous tasks, also query the final status.
Query parameters
| Field | Type | Required | Description |
|---|---|---|---|
pageSize | integer | Yes | Items per page, up to 200 |
pageNumber | integer | Yes | Page number, starting at 1 |
beginTime | integer | No | Scheduled publishing time start (inclusive), as a 13-digit Unix timestamp in milliseconds; can be provided independently. Example: 1789056000000 |
endTime | integer | No | Scheduled publishing time end (inclusive), as a 13-digit Unix timestamp in milliseconds; can be provided independently. Example: 1789142399999 |
status | WAITING_SUBMIT | SUBMITTING | PRE_CHECK_SUBMITTING | PRE_CHECK | PRE_CHECK_PASSED | PRE_CHECK_REJECTED | PENDING | PROCESSING | SUCCESS | COMPLETED | FAILED | CANCELLED | SUBMIT_FAILED | No | Publishing status |
postId | string | No | LINGTU publishing task ID |
title | string | No | Post title or caption keyword |
creatorUsername | string | No | TikTok creator username |
platform | TIKTOK | TIKTOK_SHOP | TIKTOK_BUSINESS | No | Publishing platform |
managerIds | integer[] | No | Account manager IDs; repeat the query parameter for multiple values |
noManager | boolean | No | Return accounts without an assigned manager only |
The minimal request only needs pageSize and pageNumber, for example ?pageSize=10&pageNumber=1.
Task creation does not mean platform publishing is complete. Persist postId and use this endpoint to verify the final status.
SUCCESS, COMPLETED, and PRE_CHECK_PASSED are success-like states; FAILED, SUBMIT_FAILED, and PRE_CHECK_REJECTED are failure-like states.
When both beginTime and endTime are supplied, beginTime must not exceed endTime and the interval is at most 90 days. snapshot preserves original source files and may be null for older records; photo files retain their order.
Success response
{
"code": 0,
"data": {
"list": [
{
"id": 100,
"postId": "post_xxx",
"platform": "TIKTOK_SHOP",
"title": "Summer Sale 2026 #summer",
"videoUrl": "https://cdn.ailingtu.com/media/video.mp4",
"coverUrl": "https://cdn.ailingtu.com/media/video-cover.jpg",
"reason": null,
"remark": null,
"platformPostId": "7541234567890123456",
"scheduledAt": 1784896665989,
"scheduledTz": "America/New_York",
"publishedAt": 1784896765989,
"status": "COMPLETED",
"creatorUsername": "shop_creator",
"createdByName": "Operations Team",
"productInfo": {
"productId": "1732280564607717841",
"title": "Summer Vibes Cord",
"source": "SHOP"
},
"productLinks": null,
"musicInfo": {
"id": "7567668059796720391",
"title": "original sound",
"author": "Ivan",
"duration": "15"
},
"materialType": "VIDEO",
"mediaType": "VIDEO",
"shopMaterialId": null
}
],
"total": 1,
"pageNumber": 1,
"pageSize": 10,
"totalPages": 1
},
"message": "success"
}Response and errors
Main response fields come from the published contract; see the JSON Schema. Required refers to the constraint in the containing object.
| Field | Type | Required | Description |
|---|---|---|---|
code | integer | Yes | Fixed value: 0 |
message | string | No | — |
data | object | Yes | — |
data.list | object[] | Yes | — |
data.list[].id | union | Yes | — |
data.list[].postId | string | Yes | — |
data.list[].platform | string | Yes | Allowed values: TIKTOK_SHOP, TIKTOK, TIKTOK_BUSINESS |
data.list[].title | string | Yes | — |
data.list[].videoUrl | string | null | No | — |
data.list[].coverUrl | string | null | No | — |
data.list[].reason | string | null | No | — |
data.list[].remark | string | null | No | — |
data.list[].platformPostId | string | null | No | — |
data.list[].scheduledAt | union | No | — |
data.list[].scheduledTz | string | null | No | — |
data.list[].publishedAt | integer | string | null | No | Publish time; the response may return a timestamp or a date string. |
data.list[].status | string | Yes | Allowed values: WAITING_SUBMIT, SUBMITTING, PRE_CHECK_SUBMITTING, PRE_CHECK, PRE_CHECK_PASSED, PRE_CHECK_REJECTED, PENDING, PROCESSING, SUCCESS, COMPLETED, FAILED, CANCELLED, SUBMIT_FAILED |
data.list[].creatorUsername | string | Yes | — |
data.list[].createdByName | string | null | No | — |
data.list[].productInfo | union | No | — |
data.list[].productLinks | union | No | — |
data.list[].musicInfo | union | No | — |
data.list[].materialType | string | null | No | — |
data.list[].mediaType | string | null | No | — |
data.list[].shopMaterialId | union | No | — |
data.list[].snapshot | object | null | No | Original media snapshot saved when the publishing task was created. Null for older records or tasks without files. PHOTO returns every source file. |
data.list[].snapshot.sourceFiles | object[] | No | Source files. VIDEO has one file; PHOTO returns every file in the original order. |
data.total | integer | Yes | — |
data.pageNumber | integer | Yes | — |
data.pageSize | integer | Yes | — |
data.totalPages | integer | Yes | — |
timestamp | integer | No | Response timestamp in milliseconds. |
HTTP 400The request parameters or body are invalid. Fix them and retry.HTTP 401The API key is missing or invalid. Check x-api-key.HTTP 403The API key has no permission to call this endpoint.HTTP 429Too many requests. Retry with exponential backoff.HTTP 500The server failed. Retry transient failures with exponential backoff.
Fix parameter, permission or authorization errors before retrying. If task creation times out, query existing tasks first and do not submit duplicates after an interrupted poll.
Last updated · 2026-11-16