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