{
"url": "https://www.tiktok.com/@creator/photo/7499123456789012345",
"preview_id": "a8d34c8b-6f31-4f04-8b62-6f01708af952",
"pack_id": "11111111-1111-1111-1111-111111111111",
"title": "Copied Hook Variant"
}
{
"ok": true,
"code": 201,
"message": "TikTok slideshow imported",
"data": {
"slideshow": {
"id": "2ab58bb0-0c39-45c0-a4d5-b6852f9d7fc0",
"title": "Copied Hook Variant",
"status": "draft",
"slide_count": 4
},
"source_url": "https://www.tiktok.com/@creator/photo/7499123456789012345",
"slide_count": 4,
"total_slides": 6,
"capped": true,
"credits_used": 2,
"used_cached_preview": false
}
}
Slideshows
Import TikTok Slideshow Copy
Import a TikTok slideshow into an editable Genviral draft with OCR-mapped text overlays and automatic Pinterest or selected pack backgrounds.
POST
/
api
/
partner
/
v1
/
slideshows
/
copy-tiktok
/
import
{
"url": "https://www.tiktok.com/@creator/photo/7499123456789012345",
"preview_id": "a8d34c8b-6f31-4f04-8b62-6f01708af952",
"pack_id": "11111111-1111-1111-1111-111111111111",
"title": "Copied Hook Variant"
}
{
"ok": true,
"code": 201,
"message": "TikTok slideshow imported",
"data": {
"slideshow": {
"id": "2ab58bb0-0c39-45c0-a4d5-b6852f9d7fc0",
"title": "Copied Hook Variant",
"status": "draft",
"slide_count": 4
},
"source_url": "https://www.tiktok.com/@creator/photo/7499123456789012345",
"slide_count": 4,
"total_slides": 6,
"capped": true,
"credits_used": 2,
"used_cached_preview": false
}
}
Imports TikTok slideshow content into a new draft slideshow:
- pulls TikTok slideshow slides (max
8) - extracts text overlays with vision OCR
- maps extracted text into editable text elements
- creates a Genviral draft slideshow using matching Pinterest images or your selected pack as backgrounds
- deducts copy credits and auto-refunds on failure
Idempotency
Send a uniqueIdempotency-Key header for each import you intend to create. Retrying the same key
with the same body replays the original completed operation. An uncertain or still-running import
retains its claim: retry the same key and body rather than starting another import. When the header is omitted, Genviral derives a
stable key from the credential and request body for backward compatibility, so an identical
headerless request is treated as a retry rather than a new import.
Body Parameters
string
required
TikTok slideshow URL.
string (UUID)
Optional preview token returned by Preview TikTok Slideshow
Copy. Accepted for compatibility; the canonical importer
fetches the source URL again and reports
used_cached_preview: false.string
Optional slideshow title override (max 200 chars).
string (UUID)
Optional image pack ID to source background images.
string[]
Optional direct list of image URLs for backgrounds.
string
pinterest_deck automatically finds matching Pinterest backgrounds without a pack. pack_only
uses exactly one of pack_id or pack_images. Omit this field for existing pack-based requests.
Automatic sourcing cannot be combined with either pack field.string (UUID)
Optional product reference to attach to the created slideshow.
For pack backgrounds, provide exactly one of
pack_id or pack_images. For automatic
backgrounds, send image_sourcing: "pinterest_deck" without either pack field.Example
{
"url": "https://www.tiktok.com/@creator/photo/7499123456789012345",
"preview_id": "a8d34c8b-6f31-4f04-8b62-6f01708af952",
"pack_id": "11111111-1111-1111-1111-111111111111",
"title": "Copied Hook Variant"
}
{
"ok": true,
"code": 201,
"message": "TikTok slideshow imported",
"data": {
"slideshow": {
"id": "2ab58bb0-0c39-45c0-a4d5-b6852f9d7fc0",
"title": "Copied Hook Variant",
"status": "draft",
"slide_count": 4
},
"source_url": "https://www.tiktok.com/@creator/photo/7499123456789012345",
"slide_count": 4,
"total_slides": 6,
"capped": true,
"credits_used": 2,
"used_cached_preview": false
}
}
Error Responses
400 invalid_json- request body is not valid JSON422 invalid_payload- payload validation failed422 invalid_tiktok_url- URL is not valid TikTok422 not_slideshow- TikTok post is not a slideshow/photo post404 pack_not_found422 pack_empty422 pack_source_conflict- bothpack_idandpack_imageswere sent404 product_not_found403 forbidden_product_access402 insufficient_credits- buy a credit pack athttps://www.genviral.io/billing?tab=credits, then retry429 rate_limited502 tiktok_fetch_failed500 upstream_config_error- TikTok upstream credentials/config missing500 import_failed