{"title":"LINGTU AI Open API","version":"1.11.0","lastUpdated":"2026-11-16","locale":"en-US","canonicalSpecification":"/openapi.json","workflows":[{"id":"ai-generation","markdown":"/en/openapi/workflows/ai-generation.md"},{"id":"commerce-publishing","html":"/en/openapi/workflows/commerce-publishing","markdown":"/en/openapi/workflows/commerce-publishing.md"},{"id":"creator-authorization","html":"/en/openapi/workflows/creator-authorization","markdown":"/en/openapi/workflows/creator-authorization.md"},{"id":"commerce-video","html":"/en/openapi/workflows/commerce-video","markdown":"/en/openapi/workflows/commerce-video.md"},{"id":"commerce-photo","html":"/en/openapi/workflows/commerce-photo","markdown":"/en/openapi/workflows/commerce-photo.md"}],"operations":[{"operationId":"getCreatorPost","method":"GET","path":"/v1/creator/post/detail","summary":"Returns source, schedule and platform-specific publishing options. For EXTERNAL_URL, businessId is the URL SHA-256 and videoUrl holds the original URL. snapshot can be null for older records; PHOTO snapshots preserve all source files in original order.","title":"Get publishing task details","html":"/en/openapi/post-detail","lastUpdated":"2026-11-16","tags":["Commerce Publishing"],"markdown":"/en/openapi/operations/getCreatorPost.md","schema":"/en/openapi/operations/getCreatorPost.json","relatedOperations":["updateCreatorPost","submitCreatorPost","listCreatorPosts"]},{"operationId":"listTikTokShopProducts","method":"GET","path":"/v1/creator/tiktokshop/product/listByShop","summary":"Queries shop products with pagination, keyword and sorting options. The supplied source document contains an account-list response instead of product data; the response data structure is pending confirmation.","title":"List shop products","html":"/en/openapi/shop-products","lastUpdated":"2026-11-16","tags":["Commerce Publishing"],"markdown":"/en/openapi/operations/listTikTokShopProducts.md","schema":"/en/openapi/operations/listTikTokShopProducts.json","relatedOperations":[]},{"operationId":"searchCreatorAffiliateOrders","method":"POST","path":"/v1/creator/tiktokshop/affiliateOrders/search","summary":"Queries TikTok Shop creator affiliate orders through /affiliate_creator/202410/orders/search. This is a creator-scoped endpoint: id is the creator account ID because the creator access_token is used, not a shop ID. startTime and endTime use YYYY-MM-DD and are converted from the start of the first day to the start of the day after endTime. Omit pageToken on the first request, then reuse nextPageToken with the same date range; an empty token means the last page. Amounts are localized strings with a currency; commission rates are in hundredths of a percent, so 3000 means 30%.","title":"Search affiliate orders","html":"/en/openapi/creator-affiliate-orders","lastUpdated":"2026-11-16","tags":["Commerce Publishing"],"markdown":"/en/openapi/operations/searchCreatorAffiliateOrders.md","schema":"/en/openapi/operations/searchCreatorAffiliateOrders.json","relatedOperations":["listCreatorAccounts","listCreatorPosts"]},{"operationId":"searchTikTokBusinessLocations","method":"GET","path":"/v1/creator/tiktokBusiness/searchLocation","summary":"Queries up to 20 live location tags without local storage or caching. Submit locationId and locationName together in tiktokBusiness.locationInfo or tiktokBusinessPhoto.locationInfo; a single field fails validation. Entries missing either field are omitted. The server resolves business_id from the account open_id; expired authorization returns “授权过期，请重新授权” (authorization expired, reauthorize).","title":"Search Business locations","html":"/en/openapi/business-locations","lastUpdated":"2026-11-16","tags":["Commerce Publishing"],"markdown":"/en/openapi/operations/searchTikTokBusinessLocations.md","schema":"/en/openapi/operations/searchTikTokBusinessLocations.json","relatedOperations":["createCreatorPost","updateCreatorPost"]},{"operationId":"listTikTokBusinessTrendingMusic","method":"GET","path":"/v1/creator/tiktokBusiness/trendingMusic","summary":"Queries up to 100 live commercial music library tracks without local storage or caching. Preview URLs are guaranteed for only six hours. Publish using musicSoundId (song_clip_id), never commercialMusicId. Tracks without song_clip_id are omitted. The server resolves business_id from the account open_id. Expired authorization returns “授权过期，请重新授权” (authorization expired, reauthorize); token renewal returns “账号授权需要续期，请稍后重试” (authorization needs renewal, retry later).","title":"List TikTok Business trending music","html":"/en/openapi/business-trending-music","lastUpdated":"2026-11-16","tags":["Commerce Publishing"],"markdown":"/en/openapi/operations/listTikTokBusinessTrendingMusic.md","schema":"/en/openapi/operations/listTikTokBusinessTrendingMusic.json","relatedOperations":["createCreatorPost","updateCreatorPost"]},{"operationId":"setCreatorAccountTags","method":"POST","path":"/v1/creatorAccount/setTags","summary":"Sets account tags using id or ids and tagNames. The optional append flag controls appending tags.","title":"Set creator account tags","html":"/en/openapi/set-creator-tags","lastUpdated":"2026-11-16","tags":["Commerce Publishing"],"markdown":"/en/openapi/operations/setCreatorAccountTags.md","schema":"/en/openapi/operations/setCreatorAccountTags.json","relatedOperations":[]},{"operationId":"revokeCreatorAccount","method":"POST","path":"/v1/creatorAccount/revoke","summary":"Revokes the specified creator account authorization.","title":"Revoke creator authorization","html":"/en/openapi/revoke-creator","lastUpdated":"2026-11-16","tags":["Commerce Publishing"],"markdown":"/en/openapi/operations/revokeCreatorAccount.md","schema":"/en/openapi/operations/revokeCreatorAccount.json","relatedOperations":[]},{"operationId":"syncCreatorAccount","method":"POST","path":"/v1/creatorAccount/sync","summary":"Refreshes profile data according to TIKTOK_LOGIN_KIT, TIKTOK_BUSINESS_ACCOUNT_API or TIKTOK_SHOP_CREATOR authorization. Missing or unsupported sources fail. Does not change authorization status or initiate reauthorization.","title":"Sync creator profile","html":"/en/openapi/sync-creator","lastUpdated":"2026-11-16","tags":["Commerce Publishing"],"markdown":"/en/openapi/operations/syncCreatorAccount.md","schema":"/en/openapi/operations/syncCreatorAccount.json","relatedOperations":[]},{"operationId":"unfavoriteTikTokShopMusic","method":"POST","path":"/v1/creator/tiktokshop/music/unfavorite","summary":"Idempotently removes a track from the LINGTU music favorites library for TIKTOK_SHOP. This library is stored by LINGTU and is not a TikTok official favorite. A missing entry also succeeds.","title":"Remove from LINGTU music favorites","html":"/en/openapi/unfavorite-music","lastUpdated":"2026-11-16","tags":["Commerce Publishing"],"markdown":"/en/openapi/operations/unfavoriteTikTokShopMusic.md","schema":"/en/openapi/operations/unfavoriteTikTokShopMusic.json","relatedOperations":["listTikTokShopFavoriteMusic"]},{"operationId":"favoriteTikTokShopMusic","method":"POST","path":"/v1/creator/tiktokshop/music/favorite","summary":"Idempotently adds a track to the LINGTU music favorites library for TIKTOK_SHOP. This library is stored by LINGTU and is not a TikTok official favorite. Existing entries refresh non-empty title, author, duration, coverUrl and playUrl. Use coverThumb.urlList[0] and playUrl.urlList[0] from music search for URL snapshots.","title":"Add to LINGTU music favorites","html":"/en/openapi/favorite-music","lastUpdated":"2026-11-16","tags":["Commerce Publishing"],"markdown":"/en/openapi/operations/favoriteTikTokShopMusic.md","schema":"/en/openapi/operations/favoriteTikTokShopMusic.json","relatedOperations":["listTikTokShopFavoriteMusic","unfavoriteTikTokShopMusic"]},{"operationId":"listTikTokShopFavoriteMusic","method":"GET","path":"/v1/creator/tiktokshop/music/favorites","summary":"Returns the LINGTU music favorites library for the current company, user and TIKTOK_SHOP platform, newest first. The library is stored by LINGTU and is not a TikTok official favorite. Title matching is case-insensitive. Cover and playback snapshots may expire; publish using the music ID.","title":"List LINGTU music favorites","html":"/en/openapi/favorite-music-list","lastUpdated":"2026-11-16","tags":["Commerce Publishing"],"markdown":"/en/openapi/operations/listTikTokShopFavoriteMusic.md","schema":"/en/openapi/operations/listTikTokShopFavoriteMusic.json","relatedOperations":["searchTikTokShopMusic","favoriteTikTokShopMusic","unfavoriteTikTokShopMusic"]},{"operationId":"createTikTokShopAuthorizationUrl","method":"GET","path":"/v1/creatorAccount/tiktokShopOauth/authorize","summary":"Create a TikTok Shop creator authorization URL for a market and shop type. Open the returned url in a browser or render it as a QR code for the creator.","title":"Create a TikTok Shop authorization URL","html":"/en/openapi/authorize-creator","lastUpdated":"2026-11-16","tags":["Commerce Publishing"],"markdown":"/en/openapi/operations/createTikTokShopAuthorizationUrl.md","schema":"/en/openapi/operations/createTikTokShopAuthorizationUrl.json","relatedOperations":[]},{"operationId":"listCreatorAccounts","method":"GET","path":"/v1/creatorAccount/pageList","summary":"List authorized TikTok Shop creators, regions, and posting permissions. Use id for product queries and creatorId when creating a post.","title":"List authorized creators","html":"/en/openapi/creators","lastUpdated":"2026-11-16","tags":["Commerce Publishing"],"markdown":"/en/openapi/operations/listCreatorAccounts.md","schema":"/en/openapi/operations/listCreatorAccounts.json","relatedOperations":[]},{"operationId":"listTikTokShowcaseProducts","method":"GET","path":"/v1/creator/tiktokshop/product/listByShowcase","summary":"List products in a creator showcase. Use SHOWCASE as the product source when creating a post.","title":"List showcase products","html":"/en/openapi/showcase-products","lastUpdated":"2026-11-16","tags":["Commerce Publishing"],"markdown":"/en/openapi/operations/listTikTokShowcaseProducts.md","schema":"/en/openapi/operations/listTikTokShowcaseProducts.json","relatedOperations":[]},{"operationId":"searchTikTokShopMusic","method":"GET","path":"/v1/creator/tiktokshop/searchMusic","summary":"Search TikTok Shop music available to a creator. Reuse searchId and nextPageToken for subsequent pages.","title":"Search TikTok Shop music","html":"/en/openapi/search-music","lastUpdated":"2026-11-16","tags":["Commerce Publishing"],"markdown":"/en/openapi/operations/searchTikTokShopMusic.md","schema":"/en/openapi/operations/searchTikTokShopMusic.json","relatedOperations":["listTikTokShopFavoriteMusic","favoriteTikTokShopMusic","createCreatorPost","updateCreatorPost"]},{"operationId":"addTikTokShowcaseProducts","method":"POST","path":"/v1/creator/tiktokshop/product/addToShowcase","summary":"Add TikTok Shop products to an authorized creator showcase by product IDs or a product link.","title":"Creator TTS - Add showcase products","html":"/en/openapi/add-showcase-products","lastUpdated":"2026-11-16","tags":["Commerce Publishing"],"markdown":"/en/openapi/operations/addTikTokShowcaseProducts.md","schema":"/en/openapi/operations/addTikTokShowcaseProducts.json","relatedOperations":["listTikTokShowcaseProducts","removeTikTokShowcaseProducts","moveTikTokShowcaseProductsToTop"]},{"operationId":"removeTikTokShowcaseProducts","method":"POST","path":"/v1/creator/tiktokshop/product/removeFromShowcase","summary":"Remove TikTok Shop products from an authorized creator showcase by product IDs.","title":"Creator TTS - Remove showcase products","html":"/en/openapi/remove-showcase-products","lastUpdated":"2026-11-16","tags":["Commerce Publishing"],"markdown":"/en/openapi/operations/removeTikTokShowcaseProducts.md","schema":"/en/openapi/operations/removeTikTokShowcaseProducts.json","relatedOperations":["listTikTokShowcaseProducts","addTikTokShowcaseProducts","moveTikTokShowcaseProductsToTop"]},{"operationId":"moveTikTokShowcaseProductsToTop","method":"POST","path":"/v1/creator/tiktokshop/product/moveToTopInShowcase","summary":"Move products that are already in an authorized creator showcase to the top in array order.","title":"Creator TTS - Move showcase products to top","html":"/en/openapi/move-showcase-products-to-top","lastUpdated":"2026-11-16","tags":["Commerce Publishing"],"markdown":"/en/openapi/operations/moveTikTokShowcaseProductsToTop.md","schema":"/en/openapi/operations/moveTikTokShowcaseProductsToTop.json","relatedOperations":["listTikTokShowcaseProducts","addTikTokShowcaseProducts","removeTikTokShowcaseProducts"]},{"operationId":"batchAddShopMaterials","method":"POST","path":"/v1/shop/material/batchAdd","summary":"Batch add video materials to a shop using video URLs.","title":"Batch add shop materials","html":"/en/openapi/batch-add-shop-materials","lastUpdated":"2026-11-16","tags":["Shop Materials"],"markdown":"/en/openapi/operations/batchAddShopMaterials.md","schema":"/en/openapi/operations/batchAddShopMaterials.json","relatedOperations":[]},{"operationId":"createFileUpload","method":"POST","path":"/v1/file/presign","summary":"Submit file metadata and the compatible hash to receive a fileId and object-storage URL. Skip upload and confirmation when isNew is false.","title":"Create a presigned upload","html":"/en/openapi/presign","lastUpdated":"2026-11-16","tags":["File Upload"],"markdown":"/en/openapi/operations/createFileUpload.md","schema":"/en/openapi/operations/createFileUpload.json","relatedOperations":[]},{"operationId":"confirmFileUpload","method":"POST","path":"/v1/file/confirm","summary":"Call only after a new file is successfully PUT to its presigned URL. Deduplicated files do not require confirmation.","title":"Confirm an uploaded file","html":"/en/openapi/confirm","lastUpdated":"2026-11-16","tags":["File Upload"],"markdown":"/en/openapi/operations/confirmFileUpload.md","schema":"/en/openapi/operations/confirmFileUpload.json","relatedOperations":[]},{"operationId":"uploadTikTokShopVideoCover","method":"POST","path":"/v1/creator/tiktokshop/uploadPhoto","summary":"Upload a custom TikTok Shop commerce-video cover. Pass photoFile.photoUri as tiktokShop.coverUri and place coverFileId at the request root alongside businessType.","title":"Upload a TikTok video cover","html":"/en/openapi/upload-tiktok-cover","lastUpdated":"2026-11-16","tags":["File Upload"],"markdown":"/en/openapi/operations/uploadTikTokShopVideoCover.md","schema":"/en/openapi/operations/uploadTikTokShopVideoCover.json","relatedOperations":["createCreatorPost"]},{"operationId":"createCreatorPost","method":"POST","path":"/v1/creator/post/create","summary":"Creates TikTok Shop, TikTok or TikTok Business publishing tasks. Success means accepted; inspect publishing records for completion.","title":"Create a publishing task","html":"/en/openapi/create-post","lastUpdated":"2026-11-16","tags":["Commerce Publishing"],"markdown":"/en/openapi/operations/createCreatorPost.md","schema":"/en/openapi/operations/createCreatorPost.json","relatedOperations":["listTikTokBusinessTrendingMusic","searchTikTokBusinessLocations","getCreatorPost","searchTikTokShopMusic","uploadTikTokShopVideoCover","submitCreatorPost","listCreatorPosts"]},{"operationId":"submitCreatorPost","method":"POST","path":"/v1/creator/post/submit","summary":"Submit an existing commerce video publishing task immediately using its postId.","title":"Publish a commerce video immediately","html":"/en/openapi/submit-post","lastUpdated":"2026-11-16","tags":["Commerce Publishing"],"markdown":"/en/openapi/operations/submitCreatorPost.md","schema":"/en/openapi/operations/submitCreatorPost.json","relatedOperations":["createCreatorPost","listCreatorPosts"]},{"operationId":"cancelCreatorPost","method":"POST","path":"/v1/creator/post/cancel","summary":"Cancel a publishing task that has not reached a terminal state by using its postId.","title":"Cancel a publishing task","html":"/en/openapi/cancel-post","lastUpdated":"2026-11-16","tags":["Commerce Publishing"],"markdown":"/en/openapi/operations/cancelCreatorPost.md","schema":"/en/openapi/operations/cancelCreatorPost.json","relatedOperations":["listCreatorPosts"]},{"operationId":"updateCreatorPost","method":"POST","path":"/v1/creator/post/update","summary":"Update the caption, schedule, TikTok publishing settings, and TikTok Shop product, music, and cover settings of an editable task.","title":"Update a publishing task","html":"/en/openapi/update-post","lastUpdated":"2026-11-16","tags":["Commerce Publishing"],"markdown":"/en/openapi/operations/updateCreatorPost.md","schema":"/en/openapi/operations/updateCreatorPost.json","relatedOperations":["searchTikTokShopMusic","cancelCreatorPost","listCreatorPosts"]},{"operationId":"listCreatorPosts","method":"GET","path":"/v1/creator/post/pageList","summary":"List paginated TikTok and TikTok Shop publishing records to track status and read platform post IDs, failure reasons, media, product, and scheduling details.","title":"List publishing records","html":"/en/openapi/post-records","lastUpdated":"2026-11-16","tags":["Commerce Publishing"],"markdown":"/en/openapi/operations/listCreatorPosts.md","schema":"/en/openapi/operations/listCreatorPosts.json","relatedOperations":["submitCreatorPost","updateCreatorPost","cancelCreatorPost"]},{"operationId":"createAiGenerationSchedule","method":"POST","path":"/v1/ai/schedule/create","summary":"Create scheduled AI image or video generation tasks with prompts, references, model options, dimensions, and output count. Use the returned scheduleId to query status and assets.","title":"Create an AI image or video schedule","html":"/en/openapi/schedule-create","lastUpdated":"2026-11-16","tags":["AI Content Generation"],"markdown":"/en/openapi/operations/createAiGenerationSchedule.md","schema":"/en/openapi/operations/createAiGenerationSchedule.json","relatedOperations":["listAiTasksByScheduleId"]},{"operationId":"listAiTasksByScheduleId","method":"GET","path":"/v1/ai/task/listByScheduleId","summary":"List image or video generation tasks using the scheduleId returned at creation. Poll about every five seconds until tasks complete or explicitly fail.","title":"List AI generation tasks","html":"/en/openapi/schedule-tasks","lastUpdated":"2026-11-16","tags":["AI Content Generation"],"markdown":"/en/openapi/operations/listAiTasksByScheduleId.md","schema":"/en/openapi/operations/listAiTasksByScheduleId.json","relatedOperations":["createAiGenerationSchedule"]},{"operationId":"fetchTikTokCreatorPosts","method":"GET","path":"/v1/influencer/fetchPosts","summary":"Fetch a public TikTok creator profile and recent post views, likes, comments, shares, and saves for creator analysis or monitoring.","title":"TikTok creator recent posts","html":"/en/openapi/creator-analysis-tiktok","lastUpdated":"2026-11-16","tags":["Creator Analysis"],"markdown":"/en/openapi/operations/fetchTikTokCreatorPosts.md","schema":"/en/openapi/operations/fetchTikTokCreatorPosts.json","relatedOperations":["createRelayChatCompletion"]},{"operationId":"fetchInstagramCreatorPosts","method":"GET","path":"/v1/influencer/ins/fetchPosts","summary":"Fetch a public Instagram profile and recent posts for creator analysis and content benchmarking.","title":"Instagram creator recent posts","html":"/en/openapi/creator-analysis-instagram","lastUpdated":"2026-11-16","tags":["Creator Analysis"],"markdown":"/en/openapi/operations/fetchInstagramCreatorPosts.md","schema":"/en/openapi/operations/fetchInstagramCreatorPosts.json","relatedOperations":["createRelayChatCompletion"]},{"operationId":"fetchPublicVideoData","method":"POST","path":"/v1/material/fetch","summary":"Fetch public video views and engagement metrics from TikTok, Instagram, Douyin, Xiaohongshu, WeChat Channels, and YouTube.","title":"Video data sync","html":"/en/openapi/material-fetch","lastUpdated":"2026-11-16","tags":["Content Data"],"markdown":"/en/openapi/operations/fetchPublicVideoData.md","schema":"/en/openapi/operations/fetchPublicVideoData.json","relatedOperations":[]},{"operationId":"streamViralVideoReplication","method":"POST","path":"/v1/material/analysisTask/stream","summary":"Stream a reusable replication prompt from a public video URL or an uploaded file. Concatenate result from streaming events in order; if a done event arrives, use its result as the complete prompt.","title":"Stream a viral-video replication prompt","html":"/en/openapi/viral-replication","lastUpdated":"2026-11-16","tags":["Viral Video Replication"],"markdown":"/en/openapi/operations/streamViralVideoReplication.md","schema":"/en/openapi/operations/streamViralVideoReplication.json","relatedOperations":["createFileUpload","confirmFileUpload","createAiGenerationSchedule"]},{"operationId":"createRelayChatCompletion","method":"POST","path":"/v1/relay/chat/completions","summary":"Call supported LINGTU text and vision models through one OpenAI-compatible endpoint with JSON or SSE streaming responses.","title":"AI Model API","html":"/en/openapi/ai-model-api","lastUpdated":"2026-11-16","tags":["AI Model API"],"markdown":"/en/openapi/operations/createRelayChatCompletion.md","schema":"/en/openapi/operations/createRelayChatCompletion.json","relatedOperations":[]}]}