List TikTok Posts
GET/api/tiktok-posting/posts
Lists TikTok posts, newest first, paginated (10 per page by default).
tiktok-posts:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Filters:
- filter[status]: one or more statuses, comma-separated (draft, needs_approval, scheduled, queued, uploading, processing, sent_to_inbox, published, failed, cancelled, rejected, needs_review)
- filter[store_id], filter[tiktok_account_id], filter[product_id]: comma-separated IDs
- filter[source]: ui or api
- filter[mode]: direct or inbox
- filter[privacy_level]: comma-separated privacy levels
- filter[scheduled_from] / filter[scheduled_to]: a date (Y-m-d, the whole day in the account's timezone) or an ISO-8601 timestamp
- filter[published_from] / filter[published_to]: a date (Y-m-d, the whole day in the account's timezone) or an ISO-8601 timestamp, on the publish time
- filter[archived]: 0 = active only, 1 = archived only (cancelled, rejected, or published more than 90 days ago); omit for all
- filter[search]: caption text, product SKU or name, or an exact post ID
- Operator filters: filter[
id.<op>], filter[caption.<op>], filter[status.<op>], filter[mode.<op>], filter[source.<op>], filter[privacy_level.<op>], filter[scheduled_at.<op>], filter[published_at.<op>], filter[created_at.<op>], and the filter_groups tree
Sorts: id, scheduled_at, published_at, created_at, updated_at, status, scheduled_or_published_at (published time, else scheduled time — the queue's "Scheduled / published" column) (prefix - for descending; default -id).
Status needs_review (label "Check TikTok before retrying") means TikTok may have received the post but its answer was lost. SKU.io keeps checking TikTok and settles it automatically; until then it cannot be edited or retried. An approver can settle it with Resolve TikTok Post.
Scope: tiktok-posts:read. Permission: tiktok_posts.view.
Request
Responses
- 200
- 401
- 403
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.