您的浏览器不支持JavaScript,请启用JavaScript以获得最佳体验。
Get publishing task details
Developer docs / Publishing tasks

Get publishing task details

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.

GET/v1/creator/post/detail
Authentication:
Request header x-api-key: <YOUR_API_KEY>; keep the key on the server and never expose it in client code, logs or shared files.
Success criteria:
HTTP 2xx with code=0; for asynchronous tasks, also query the final status.

Query parameters

FieldTypeRequiredDescription
postIdstringYesPublishing task ID
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.
Success response
{
  "code": 0,
  "message": "success",
  "data": {
    "postId": "2011014932023390208",
    "platform": "TIKTOK_BUSINESS",
    "businessType": "FILE",
    "businessId": "591",
    "title": "New collection",
    "videoUrl": "https://cdn.example.com/video.mp4",
    "snapshot": {
      "sourceFiles": [
        {
          "materialType": "VIDEO",
          "name": "video.mp4",
          "uploadedAt": "2026-09-29 10:00:00"
        }
      ]
    },
    "scheduledAt": 1790640000000,
    "scheduledTz": "Asia/Shanghai",
    "status": "SCHEDULED",
    "tiktokBusiness": {
      "musicSoundInfo": {
        "musicSoundId": "7123456789012345678",
        "musicSoundName": "Sunrise",
        "musicSoundArtist": "Example artist",
        "musicSoundVolume": 50,
        "videoOriginalSoundVolume": 50
      },
      "locationInfo": {
        "locationId": "loc-1",
        "locationName": "London"
      }
    }
  },
  "timestamp": 1790640000000
}

Response and errors

Main response fields come from the published contract; see the JSON Schema. Required refers to the constraint in the containing object.

FieldTypeRequiredDescription
codeintegerYes—
messagestringYes—
dataobjectYes—
data.postIdstringYes—
data.platformstringYes—
data.businessTypestringNoMaterial source, such as FILE or EXTERNAL_URL
data.businessIdstringNoFILE is the file ID; EXTERNAL_URL is the SHA-256 of the original URL. The original URL is in videoUrl.
data.titlestringYes—
data.videoUrlstringYes—
data.snapshotobject | nullNoOriginal media snapshot saved when the publishing task was created. Null for older records or tasks without files. PHOTO returns every source file.
data.snapshot.sourceFilesobject[]NoSource files. VIDEO has one file; PHOTO returns every file in the original order.
data.snapshot.sourceFiles[].materialTypestringYesSource media type: VIDEO or PHOTO
data.snapshot.sourceFiles[].namestringYesSource file name
data.snapshot.sourceFiles[].uploadedAtstringYesSource file upload time
data.scheduledAtintegerYes—
data.scheduledTzstringYes—
data.statusstringYes—
data.tiktokShopunionNo—
data.tiktokobjectNo—
data.tiktok.coverTimestampMsintegerYes—
data.tiktok.privacyLevelstringYes—
data.tiktok.disableCommentbooleanYes—
data.tiktok.disableDuetbooleanYes—
data.tiktok.disableStitchbooleanYes—
data.tiktok.brandContentTogglebooleanYes—
data.tiktok.brandOrganicTogglebooleanYes—
data.tiktok.aigcbooleanYes—
data.tiktokBusinessobjectNoOptional Business video settings without privacyLevel. coverFileId takes precedence over coverTimestampMs, and interactions disabled at account level can only stay disabled.
data.tiktokBusiness.disableCommentbooleanNoDisable comments. Must be true when comments are disabled at account level
data.tiktokBusiness.disableDuetbooleanNoDisable Duet. Must be true when Duet is disabled at account level
data.tiktokBusiness.disableStitchbooleanNoDisable Stitch. Must be true when Stitch is disabled at account level
data.tiktokBusiness.coverTimestampMsintegerNoVideo frame timestamp used as the cover (milliseconds)
data.tiktokBusiness.brandContentTogglebooleanNoBrand content (paid partnership)
data.tiktokBusiness.brandOrganicTogglebooleanNoBrand organic (promoting your own business)
data.tiktokBusiness.aigcbooleanNoAI-generated content
data.tiktokBusiness.musicSoundInfoobjectNoUse musicSoundId (song_clip_id), never commercialMusicId. Omit it to publish without platform music; title and artist are display snapshots.
data.tiktokBusiness.musicSoundInfo.musicSoundIdstringNomusicSoundId from the trending music endpoint (the platform song_clip_id); never use commercialMusicId
data.tiktokBusiness.musicSoundInfo.musicSoundNamestringNoTrack title snapshot for display and detail lookups; publishing uses musicSoundId
data.tiktokBusiness.musicSoundInfo.musicSoundArtiststringNoArtist snapshot for display and detail lookups
data.tiktokBusiness.musicSoundInfo.musicSoundVolumeintegerNoMusic volume 0-100; defaults to 50 (the platform treats a missing volume as 0, which is muted)
data.tiktokBusiness.musicSoundInfo.videoOriginalSoundVolumeintegerNoOriginal video volume 0-100; defaults to 50
data.tiktokBusiness.locationInfoobjectNoSubmit locationId and locationName together; locationAddress is display-only.
data.tiktokBusiness.locationInfo.locationIdstringNolocationId from the location search endpoint; publishing maps it to post_info.location_id
data.tiktokBusiness.locationInfo.locationNamestringNoLocation name, submitted together with the ID (post_info.location_name)
data.tiktokBusiness.locationInfo.locationAddressstringNoExtra address for display and detail lookups only; never sent to the platform
data.tiktokBusinessPhotoobjectNoTikTok Business photo options. Required when platform=TIKTOK_BUSINESS and mediaType=PHOTO, and cannot be combined with tiktokShopPhoto. Pass our file IDs; the server resolves them to public image URLs. The privacy level must be one of the values allowed for the account, otherwise the task fails.
data.tiktokBusinessPhoto.businessIdsinteger[]YesImage file IDs in display order, 1–15 images
data.tiktokBusinessPhoto.photoUrlsstring[]NoImage URLs resolved by the server; do not send them
data.tiktokBusinessPhoto.photoCoverIndexintegerNoCover image index starting at 0; defaults to 0
data.tiktokBusinessPhoto.privacyLevelstringYesPrivacy level; required and must be one of the values allowed for the account
data.tiktokBusinessPhoto.autoAddMusicbooleanNoIgnored when musicSoundInfo.musicSoundId is present; the server always sends false.
data.tiktokBusinessPhoto.disableCommentbooleanNoDisable comments. Must be true when comments are disabled at account level
data.tiktokBusinessPhoto.brandOrganicTogglebooleanNoBrand organic (promoting your own business)
data.tiktokBusinessPhoto.brandContentTogglebooleanNoBrand content (paid partnership)
data.tiktokBusinessPhoto.locationInfoobjectNoSubmit locationId and locationName together; locationAddress is display-only.
data.tiktokBusinessPhoto.locationInfo.locationIdstringNolocationId from the location search endpoint; publishing maps it to post_info.location_id
data.tiktokBusinessPhoto.locationInfo.locationNamestringNoLocation name, submitted together with the ID (post_info.location_name)
data.tiktokBusinessPhoto.locationInfo.locationAddressstringNoExtra address for display and detail lookups only; never sent to the platform
data.tiktokBusinessPhoto.musicSoundInfoobjectNoSelected commercial music, sharing the same structure as non-commerce videos. Omit it (or musicSoundId) to publish without platform music. Photo publishing has no volume options: only musicSoundId is sent to TikTok (post_info.music_sound_info.music_sound_id), and the title and artist are display snapshots.
data.tiktokBusinessPhoto.musicSoundInfo.musicSoundIdstringNomusicSoundId from the trending music endpoint (the platform song_clip_id). Never use commercialMusicId. Photo publishing maps it to post_info.music_sound_info.music_sound_id
data.tiktokBusinessPhoto.musicSoundInfo.musicSoundNamestringNoTrack title snapshot for display and detail lookups; publishing uses musicSoundId
data.tiktokBusinessPhoto.musicSoundInfo.musicSoundArtiststringNoArtist snapshot for display and detail lookups
timestampintegerYes—

Fix parameter, permission or authorization errors before retrying. If task creation times out, query existing tasks first and do not submit duplicates after an interrupted poll.

Last updated · 2026-11-16