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

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.

Prerequisite: complete creator authorization flow

Publishing flow

YesNoImmediatelyScheduled
Prerequisite: authorized creator
Authorized and has photo publishing permission; authSource=TIKTOK_SHOP_CREATOR + hasPhotoPermission=true
Select creators
Pick authorized creators with photo permission; use creatorId for tasks
Select products
Shop products or showcase products, by product ID or link
Set the schedule
Timezone, dates and posts per day, or publish immediately
UI only
Upload photos
1–15 ordered images; the order is the display order
Commerce settings
Product title, music and AI label; no cover or pre-check
Step 5: validate
No pre-check; title, images, product and time
UI only
Create publishing task
Immediate: scheduledAt=now; scheduled: planned time + scheduledTz
Publishing records
Status, platform post ID, failure reason; submit, update or cancel while pending
Deduplicated file
Reuse returned fileIds; skip PUT and confirm for existing images
presign isNew?Scheduled?
TikTok Shop commerce photo publishing flow: select an authorized creator, products and schedule, media upload, commerce settings, validation, publishing task and records.

What each step does

01

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
02

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
03

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
04

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
05

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
06

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.