# info.summary
TikTok commerce-content publishing and public content data APIs.

# info.description
Use the LINGTU AI OpenAPI to query authorized creators and TikTok Shop products, upload media, create TikTok Shop video or photo publishing tasks, and fetch public content metrics.  A request succeeds only when the HTTP status is successful and the response body has `code: 0`.

# tags[].description
Authorized creators, TikTok Shop products, and publishing tasks.

# tags[].description
Presigned media upload and confirmation.

# paths./v1/creatorAccount/pageList.get.description
Returns authorized creator accounts and publishing permissions. Use `id` for product queries and `creatorId` when creating publishing tasks.

# paths./v1/creatorAccount/pageList.get.parameters[].description
Authorization source. Use TIKTOK_SHOP_CREATOR for commerce publishing.

# paths./v1/creatorAccount/pageList.get.parameters[].description
TikTok usernames. Repeat the query parameter for multiple values.

# paths./v1/creatorAccount/pageList.get.parameters[].description
Return accounts with shoppable photo permission only.

# paths./v1/creatorAccount/pageList.get.responses.403.description
The API key does not have permission for this operation.

# paths./v1/creatorAccount/pageList.get.responses.429.description
Too many requests. Retry with exponential backoff.

# paths./v1/creatorAccount/pageList.get.responses.429.headers.Retry-After.description
Seconds to wait before retrying, when provided.

# paths./v1/creatorAccount/pageList.get.responses.500.description
Unexpected server error. Retry transient failures with exponential backoff.

# paths./v1/creatorAccount/pageList.get.x-ui.summary
查询 TikTok Shop 已授权达人、目标地区和发布权限。响应中的 id 用于查商品，creatorId 用于创建发布任务。

# paths./v1/creatorAccount/pageList.get.x-ui.summaryEn
List authorized TikTok Shop creators, regions, and posting permissions. Use id for product queries and creatorId when creating a post.

# paths./v1/creatorAccount/pageList.get.x-ui.parameters[].description
是否只返回有效授权，默认 true

# paths./v1/creatorAccount/pageList.get.x-ui.parameters[].descriptionEn
Return valid authorizations only; defaults to true

# paths./v1/creatorAccount/pageList.get.x-ui.parameters[].descriptionEn
Use TIKTOK_SHOP_CREATOR for commerce posts

# paths./v1/creatorAccount/pageList.get.x-ui.parameters[].description
重复 Query 参数传递多个用户名

# paths./v1/creatorAccount/pageList.get.x-ui.parameters[].descriptionEn
Repeat the query parameter for multiple usernames

# paths./v1/creatorAccount/pageList.get.x-ui.parameters[].description
仅返回有带货图文权限的账号

# paths./v1/creatorAccount/pageList.get.x-ui.parameters[].descriptionEn
Return accounts with shoppable photo permission only

# paths./v1/creator/tiktokshop/product/listByShop.get.description
Lists shop products using the creator account `id`. Use `SHOP` as the product source when creating a publishing task.

# paths./v1/creator/tiktokshop/product/listByShop.get.parameters[].description
Creator account table ID, not creatorId.

# paths./v1/creator/tiktokshop/product/listByShop.get.parameters[].description
Pagination token from the previous response.

# paths./v1/creator/tiktokshop/product/listByShop.get.responses.403.description
The API key does not have permission for this operation.

# paths./v1/creator/tiktokshop/product/listByShop.get.responses.429.description
Too many requests. Retry with exponential backoff.

# paths./v1/creator/tiktokshop/product/listByShop.get.responses.429.headers.Retry-After.description
Seconds to wait before retrying, when provided.

# paths./v1/creator/tiktokshop/product/listByShop.get.responses.500.description
Unexpected server error. Retry transient failures with exponential backoff.

# paths./v1/creator/tiktokshop/product/listByShop.get.x-ui.summary
使用达人账号表 id 查询 TikTok Shop 店铺商品。创建发布任务时，商品来源 source 应传 SHOP。

# paths./v1/creator/tiktokshop/product/listByShop.get.x-ui.summaryEn
List TikTok Shop products using the creator account id. Use SHOP as the product source when creating a post.

# paths./v1/creator/tiktokshop/product/listByShop.get.x-ui.parameters[].description
上一页返回的分页 Token

# paths./v1/creator/tiktokshop/product/listByShop.get.x-ui.parameters[].descriptionEn
Pagination token from the previous response

# paths./v1/creator/tiktokshop/product/listByShowcase.get.description
Lists products in a creator showcase. Use `SHOWCASE` as the product source when creating a publishing task.

# paths./v1/creator/tiktokshop/product/listByShowcase.get.parameters[].description
Pagination token from the previous response.

# paths./v1/creator/tiktokshop/product/listByShowcase.get.responses.403.description
The API key does not have permission for this operation.

# paths./v1/creator/tiktokshop/product/listByShowcase.get.responses.429.description
Too many requests. Retry with exponential backoff.

# paths./v1/creator/tiktokshop/product/listByShowcase.get.responses.429.headers.Retry-After.description
Seconds to wait before retrying, when provided.

# paths./v1/creator/tiktokshop/product/listByShowcase.get.responses.500.description
Unexpected server error. Retry transient failures with exponential backoff.

# paths./v1/creator/tiktokshop/product/listByShowcase.get.x-ui.summary
查询达人橱窗商品，响应结构与店铺商品一致。创建发布任务时，商品来源 source 应传 SHOWCASE。

# paths./v1/creator/tiktokshop/product/listByShowcase.get.x-ui.summaryEn
List products in a creator showcase. The response matches shop products; use SHOWCASE as the product source.

# paths./v1/creator/tiktokshop/product/listByShowcase.get.x-ui.parameters[].description
上一页返回的分页 Token

# paths./v1/creator/tiktokshop/product/listByShowcase.get.x-ui.parameters[].descriptionEn
Pagination token from the previous response

# paths./v1/creator/tiktokshop/product/listByShowcase.get.x-ui.notes[]
该接口不接收 titleKeyword；如需搜索，请在客户端按 title 过滤。

# paths./v1/creator/tiktokshop/product/listByShowcase.get.x-ui.notesEn[]
This endpoint does not accept titleKeyword. Filter by title on the client when needed.

# paths./v1/file/presign.post.description
Returns a file ID and a presigned object-storage URL. When `isNew` is false, skip PUT and confirmation. When `isNew` is true, PUT the raw file bytes to `uploadUrl` with the same Content-Type, without the x-api-key header, then confirm the upload.

# paths./v1/file/presign.post.responses.403.description
The API key does not have permission for this operation.

# paths./v1/file/presign.post.responses.429.description
Too many requests. Retry with exponential backoff.

# paths./v1/file/presign.post.responses.429.headers.Retry-After.description
Seconds to wait before retrying, when provided.

# paths./v1/file/presign.post.responses.500.description
Unexpected server error. Retry transient failures with exponential backoff.

# paths./v1/file/presign.post.x-ui.summary
提交文件信息和兼容 Hash，获取 fileId 与对象存储上传地址。isNew=false 表示文件已存在，可跳过上传和确认。

# paths./v1/file/presign.post.x-ui.summaryEn
Submit file metadata and the compatible hash to receive a fileId and object-storage URL. Skip upload and confirmation when isNew is false.

# paths./v1/file/presign.post.x-ui.parameters[].descriptionEn
SHA-256 of the UTF-8 encoded lowercase hex representation of the file bytes

# paths./v1/file/presign.post.x-ui.notes[]
isNew=true 时，使用相同 Content-Type 将原始文件 PUT 到 uploadUrl，成功后再调用 confirm。

# paths./v1/file/presign.post.x-ui.notesEn[]
When isNew is true, PUT the raw file to uploadUrl with the same Content-Type, then call confirm.

# paths./v1/file/presign.post.x-ui.notesEn[]
Do not send x-api-key to the object-storage PUT URL.

# paths./v1/file/confirm.post.description
Call only after a new file is successfully uploaded to its presigned URL. Deduplicated files do not require confirmation.

# paths./v1/file/confirm.post.responses.403.description
The API key does not have permission for this operation.

# paths./v1/file/confirm.post.responses.429.description
Too many requests. Retry with exponential backoff.

# paths./v1/file/confirm.post.responses.429.headers.Retry-After.description
Seconds to wait before retrying, when provided.

# paths./v1/file/confirm.post.responses.500.description
Unexpected server error. Retry transient failures with exponential backoff.

# paths./v1/file/confirm.post.x-ui.summary
仅在新文件成功 PUT 到预签名地址后调用。秒传文件不需要确认。

# paths./v1/file/confirm.post.x-ui.summaryEn
Call only after a new file is successfully PUT to its presigned URL. Deduplicated files do not require confirmation.

# paths./v1/file/confirm.post.x-ui.parameters[].description
预签名接口返回的文件 ID

# paths./v1/file/confirm.post.x-ui.parameters[].descriptionEn
File ID returned by the presign endpoint

# paths./v1/creator/post/create.post.description
Creates a TikTok Shop commerce video or photo publishing task. A successful response means the task was accepted, not that TikTok publishing has completed.

# paths./v1/creator/post/create.post.responses.403.description
The API key does not have permission for this operation.

# paths./v1/creator/post/create.post.responses.429.description
Too many requests. Retry with exponential backoff.

# paths./v1/creator/post/create.post.responses.429.headers.Retry-After.description
Seconds to wait before retrying, when provided.

# paths./v1/creator/post/create.post.responses.500.description
Unexpected server error. Retry transient failures with exponential backoff.

# paths./v1/creator/post/create.post.x-ui.summary
创建 TikTok Shop 带货视频或带货图文发布任务。请求成功仅表示任务已接收，最终结果请在发布记录中确认。

# paths./v1/creator/post/create.post.x-ui.summaryEn
Create a TikTok Shop commerce video or photo publishing task. A successful response means the task was accepted; verify the final result in publishing records.

# paths./v1/creator/post/create.post.x-ui.parameters[].descriptionEn
Video fileId; first image fileId for photo posts

# paths./v1/creator/post/create.post.x-ui.parameters[].description
上传文件固定传 FILE

# paths./v1/creator/post/create.post.x-ui.parameters[].descriptionEn
creatorId returned by the creator endpoint

# paths./v1/creator/post/create.post.x-ui.parameters[].description
发布文案，最长 4000 字符

# paths./v1/creator/post/create.post.x-ui.notes[]
图文支持 1～15 张图片和 1 个商品；businessId 必须等于 businessIds[0]。

# paths./v1/creator/post/create.post.x-ui.notes[]
保存 postId 和 status，并前往发布记录确认最终状态。

# paths./v1/creator/post/create.post.x-ui.notesEn[]
Photo posts support 1–15 images and one product; businessId must equal businessIds[0].

# paths./v1/creator/post/create.post.x-ui.notesEn[]
Persist postId and status, then verify the final state in publishing records.

# paths./v1/material/fetch.post.description
Fetches public video views and engagement metrics. Supported sources include TikTok, Instagram, Douyin, Xiaohongshu, WeChat Channels, and YouTube.

# paths./v1/material/fetch.post.responses.200.description
Public video data returned successfully.

# paths./v1/material/fetch.post.responses.403.description
The API key does not have permission for this operation.

# paths./v1/material/fetch.post.responses.404.description
The public work does not exist or has been deleted.

# paths./v1/material/fetch.post.responses.429.description
Too many requests. Retry with exponential backoff.

# paths./v1/material/fetch.post.responses.429.headers.Retry-After.description
Seconds to wait before retrying, when provided.

# paths./v1/material/fetch.post.responses.500.description
Unexpected server error. Retry transient failures with exponential backoff.

# paths./v1/material/fetch.post.x-ui.summary
根据公开作品链接同步 TikTok、Instagram、抖音、小红书、视频号和 YouTube 的播放与互动数据。

# paths./v1/material/fetch.post.x-ui.summaryEn
Fetch public video views and engagement metrics from TikTok, Instagram, Douyin, Xiaohongshu, WeChat Channels, and YouTube.

# components.securitySchemes.ApiKeyAuth.description
LINGTU AI API key. Keep it on the server and never expose it in client-side code or logs.

# components.schemas.ErrorResponse.properties.code.description
Non-zero business or HTTP-aligned error code.

# components.schemas.CreatorAccount.properties.id.description
Account table ID used by product query endpoints.

# components.schemas.CreatorAccount.properties.creatorId.description
Creator business ID used when creating publishing tasks.

# components.schemas.PresignRequest.properties.hash.description
Compatibility hash: lowercase hex of the raw file bytes, UTF-8 encoded, then SHA-256.

# components.schemas.PostRequestBase.properties.scheduledTz.description
IANA timezone, for example America/New_York.

# components.schemas.MaterialFetchResponse.properties.data.description
Normalized and platform-specific public content fields.