您的浏览器不支持JavaScript,请启用JavaScript以获得最佳体验。

LINGTU AI OpenAPI

Commerce publishing overview

Commerce publishing covers TikTok Shop commerce videos and commerce photo posts only. Both share authorization, product selection, scheduling, task creation and records; the differences live in media and commerce settings, so the details are maintained on two separate pages.

Choose a publishing type

Shared publishing path

01

Step 1 · Creator authorization

Get the authorization URL, let the creator authorize, then list usable creators after the callback page confirms success.

  • oauthRegion selects the market and shop type
  • The creator authorizes with the TikTok account that has commerce permission
  • The callback page must show “SUCCESS/成功”; one QR code can only be used for one account
  • List accounts with authSource=TIKTOK_SHOP_CREATOR; photo posts add hasPhotoPermission=true
02

Step 2 · Products and schedule

Pick shop or showcase products and set the publishing dates.

  • Product queries use the account id; publishing uses creatorId
  • Add missing products by ID or link
  • Set timezone, dates and posts per day, or publish immediately
03

Step 3 · Media and settings

Upload the video or images and set the product title, music and optional cover.

  • Video: one file through presign → PUT → confirm
  • Photo: 1–15 images in display order, each through presign
  • Product title is required; music comes from search or the LINGTU favorites library
04

Step 4 · Validate and create tasks

Validate the row and call createPost for each task.

  • Video pre-check is optional and off by default
  • Scheduled tasks must be at least 5 minutes ahead
  • Validate title, media, product and time
05

After publishing · Records

Track the final status, platform post ID and failures.

  • Creation success only means the task was accepted
  • Submit scheduled tasks immediately, update or cancel when possible
  • Confirm the final platform status from records

Video / photo differences

Video: 1 file + optional pre-check

One video per task. Pre-check is optional and only for videos. Cover can be a frame or an uploaded image.

Photo: 1–15 ordered images

Photo posts require the photo permission, use display order for businessIds, and have no cover or pre-check.

Creation vs publishing

createPost only accepts the task; records hold pre-check results, platform post ID and failure reasons.

Scheduled or immediate

Scheduled tasks must be at least 5 minutes ahead; immediate publishing uses the current time as scheduledAt.

Integration notes

  • Commerce publishing only accepts TikTok Shop authorized creators; photo posts also need photo permission.
  • Generate authorization URLs on the server; never expose the API key.
  • Use the account id for product queries and creatorId for publishing tasks.
  • Keep products in stock before publishing to avoid losing the shopping anchor.