{
"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
}
}
Slideshows
Preview TikTok Slideshow Copy
Fetch TikTok slideshow metadata + image URLs before importing into an editable Genviral slideshow.
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
}
}
Use this endpoint to validate a TikTok slideshow URL and preview import inputs before spending credits.
The preview returns source metadata, image URLs, slide limits, and estimated credits for review.
preview_id is accepted for compatibility; the canonical import fetches the URL again instead
of treating the preview as authority to create a slideshow. Import requires a separate explicit
request and an idempotency key.
Image URLs remain provider-hosted and can expire. Slideshow Studio loads approved HTTPS TikTok
CDNs without a referrer. If a preview host is outside its bounded image policy, the widget shows
an unavailable preview and offers a link to review the source on TikTok.
Body Parameters
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 JSON422 invalid_payload- payload is missing required fields422 invalid_tiktok_url- URL is not a valid TikTok link422 not_slideshow- TikTok URL is valid but not a slideshow/photo post429 rate_limited502 tiktok_fetch_failed- upstream TikTok fetch failed500 upstream_config_error- TikTok upstream credentials/config missing500 preview_failed