LINGTU AI OpenAPI
Commerce photo publishing flow
This page covers TikTok Shop commerce photo posts only. The creator must be authorized through TikTok Shop and have the photo publishing permission; then follow: select creators → products and schedule → image upload and settings → validation and task creation → publishing records. Photo posts have no pre-check.
Publishing flow
What each step does
Step 1 · Select creators
Choose an authorized creator account that has the photo publishing permission.
- List with hasPhotoPermission=true, then confirm permissions contains PHOTO_SHOPPABLE_PERMISSION_PRODUCT or PHOTO_SHOPPABLE_PERMISSION_SHOP; without either there is no photo permission
- Use creatorId for publishing tasks and the account id for product queries
Step 2 · Products and schedule
Choose a shop or showcase product and set the publishing dates.
- Products come from the shop or the showcase; add a product by ID or link when it is missing
- Set the publishing timezone, dates and posts per day, or publish immediately
- Keep the product in stock, otherwise the platform may drop the shopping anchor
Step 3 · Upload images
Upload 1–15 images in display order through presigned storage.
- Each image goes through presign; PUT only when isNew=true, then confirm
- Keep the upload order; it becomes the post display order
- One task accepts 1–15 images
- businessIds in createPost use string file IDs in display order
Step 4 · Commerce settings
Set the product title, music and AI-generated label for each photo post.
- Product title is required and editable; forbidden characters and length are validated
- Search music or reuse the LINGTU favorites library; publish with musicId
- Photo posts have no cover setting and no video pre-check
- Mark the content as AI-generated when applicable
Step 5 · Validate and create the task
Validate images, product and schedule, then create the publishing task.
- Check 1–15 images, product, title and scheduled time (at least 5 minutes ahead)
- Photo posts skip the pre-check step entirely
- Call createPost with mediaType=PHOTO and tiktokShopPhoto.postType=MULTI_PHOTO_ONE_ANCHOR
- businessIds and productLinks describe the images and the anchor
After publishing · Records
Track platform post ID and failures.
- Creation success only means the task was accepted
- Query publishing records and details for the final status
- Submit a scheduled task immediately, edit tasks that can still change, or cancel
- Store the postId for follow-up
Key branches
Photo permission required
permissions must contain PHOTO_SHOPPABLE_PERMISSION_PRODUCT or PHOTO_SHOPPABLE_PERMISSION_SHOP; without either, the account cannot publish commerce photos.
1–15 images, order matters
businessIds follow display order; reorder before creating the task, not after publishing.
No pre-check
Commerce photo posts have no pre-check step; validation happens before createPost and the platform reports failures in publishing records.
Scheduled or immediate
Scheduled tasks must be at least 5 minutes ahead; immediate publishing sets scheduledAt to the current time.
Creation vs publishing
createPost only accepts the task; use publishing records for the final platform status.
Integration notes
- Authorization alone is not enough: commerce photo posts also require the shoppable photo permission.
- Keep the image order stable; businessIds are display order and cannot be reordered after publishing.
- Use string file IDs in businessIds, not numeric IDs.
- scheduledAt is an absolute timestamp, scheduledTz is the IANA timezone of the target market.
- When isNew=false, reuse the fileId instead of uploading the same image again.