# List publishing records

- API version: 1.11.0
- Last updated: 2026-11-16
- Server: `https://api.ailingtu.com`
- Web document: [List publishing records](/en/openapi/post-records)
- Full schema: [JSON Schema](/en/openapi/operations/listCreatorPosts.json)
- Discovery: [Operation index](/en/openapi/operations/index.json)

## GET /v1/creator/post/pageList

Operation ID: `listCreatorPosts`

List paginated TikTok and TikTok Shop publishing records to track status and read platform post IDs, failure reasons, media, product, and scheduling details.

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.

### Request parameters

| Field | Location | Type | Required | Description |
|---|---|---|---|---|
| `pageSize` | query | integer | Yes | Items per page, up to 200 |
| `pageNumber` | query | integer | Yes | Page number, starting at 1 |
| `beginTime` | query | integer | No | Scheduled publishing time start (inclusive), as a 13-digit Unix timestamp in milliseconds; can be provided independently. Example: 1789056000000 |
| `endTime` | query | integer | No | Scheduled publishing time end (inclusive), as a 13-digit Unix timestamp in milliseconds; can be provided independently. Example: 1789142399999 |
| `status` | query | 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` | query | string | No | LINGTU publishing task ID |
| `title` | query | string | No | Post title or caption keyword |
| `creatorUsername` | query | string | No | TikTok creator username |
| `platform` | query | TIKTOK \| TIKTOK_SHOP \| TIKTOK_BUSINESS | No | Publishing platform |
| `managerIds` | query | integer[] | No | Account manager IDs; repeat the query parameter for multiple values |
| `noManager` | query | boolean | No | Return accounts without an assigned manager only |

### Success response

```json
{
  "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 fields

Main levels are listed below. The endpoint JSON Schema is authoritative for the full structure, unions and validation rules; Required refers to 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. |

### Integration notes and limits

- 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.

### Error handling

| HTTP | Description |
|---|---|
| 400 | The request parameters or body are invalid. Fix them and retry. |
| 401 | The API key is missing or invalid. Check x-api-key. |
| 403 | The API key has no permission to call this endpoint. |
| 429 | Too many requests. Retry with exponential backoff. |
| 500 | The server failed. Retry transient failures with exponential backoff. |

Treat any non-zero business code as a failure. Do not blindly retry parameter, permission or authorization errors. If creating a publishing or generation task times out, query the existing task first instead of creating another one.

### Related endpoints

- [Publish a commerce video immediately](/en/openapi/submit-post) · [Markdown](/en/openapi/operations/submitCreatorPost.md)
- [Update a publishing task](/en/openapi/update-post) · [Markdown](/en/openapi/operations/updateCreatorPost.md)
- [Cancel a publishing task](/en/openapi/cancel-post) · [Markdown](/en/openapi/operations/cancelCreatorPost.md)
