Skip to main content

List TikTok Posts

GET 

/api/tiktok-posting/posts

Lists TikTok posts, newest first, paginated (10 per page by default).

Required scope: tiktok-posts:read

Grant 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​

OK

Response Headers
    Content-Type