Preview TikTok Slideshow Copy

{
  "url": "https://www.tiktok.com/@creator/photo/7499123456789012345"
}

{
  "ok": true,
  "code": 200,
  "message": "TikTok slideshow preview ready",
  "data": {
    "preview_id": "a8d34c8b-6f31-4f04-8b62-6f01708af952",
    "source_url": "https://www.tiktok.com/@creator/photo/7499123456789012345",
    "images": [
      "https://p16-sign.tiktokcdn.com/.../slide-1.jpeg",
      "https://p16-sign.tiktokcdn.com/.../slide-2.jpeg"
    ],
    "caption": "5 hooks that always convert",
    "author": "creator",
    "slide_count": 2,
    "total_slides": 2,
    "capped": false,
    "estimated_credits": 1
  }
}

POST

api

partner

slideshows

copy-tiktok

preview

{
  "url": "https://www.tiktok.com/@creator/photo/7499123456789012345"
}

{
  "ok": true,
  "code": 200,
  "message": "TikTok slideshow preview ready",
  "data": {
    "preview_id": "a8d34c8b-6f31-4f04-8b62-6f01708af952",
    "source_url": "https://www.tiktok.com/@creator/photo/7499123456789012345",
    "images": [
      "https://p16-sign.tiktokcdn.com/.../slide-1.jpeg",
      "https://p16-sign.tiktokcdn.com/.../slide-2.jpeg"
    ],
    "caption": "5 hooks that always convert",
    "author": "creator",
    "slide_count": 2,
    "total_slides": 2,
    "capped": false,
    "estimated_credits": 1
  }
}

Use this endpoint to validate a TikTok slideshow URL and preview import inputs before spending credits. The preview is cached server-side (10 minutes) and returns preview_id so the follow-up import call can skip re-fetching upstream TikTok data.

Body Parameters

url

string

required

TikTok slideshow URL. Supports standard and short TikTok links.

Example

{
  "url": "https://www.tiktok.com/@creator/photo/7499123456789012345"
}

{
  "ok": true,
  "code": 200,
  "message": "TikTok slideshow preview ready",
  "data": {
    "preview_id": "a8d34c8b-6f31-4f04-8b62-6f01708af952",
    "source_url": "https://www.tiktok.com/@creator/photo/7499123456789012345",
    "images": [
      "https://p16-sign.tiktokcdn.com/.../slide-1.jpeg",
      "https://p16-sign.tiktokcdn.com/.../slide-2.jpeg"
    ],
    "caption": "5 hooks that always convert",
    "author": "creator",
    "slide_count": 2,
    "total_slides": 2,
    "capped": false,
    "estimated_credits": 1
  }
}

slide_count is the number of slides that will be imported (max 8). If TikTok has more slides, capped=true and total_slides shows the original count.

Error Responses

400 invalid_json - request body is not valid JSON
422 invalid_payload - payload is missing required fields
422 invalid_tiktok_url - URL is not a valid TikTok link
422 not_slideshow - TikTok URL is valid but not a slideshow/photo post
429 rate_limited
502 tiktok_fetch_failed - upstream TikTok fetch failed
500 upstream_config_error - TikTok upstream credentials/config missing
500 preview_failed

Regenerate Slide Import TikTok Slideshow Copy

​Body Parameters

​Example

​Error Responses

Body Parameters

Example

Error Responses