Skip to main content
POST
/
api
/
partner
/
v1
/
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
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.genviral.io/llms.txt

Use this file to discover all available pages before exploring further.

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