> ## 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.

# Preview TikTok Slideshow Copy

> Fetch TikTok slideshow metadata + image URLs before importing into an editable Genviral slideshow.

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

<ParamField body="url" type="string" required>
  TikTok slideshow URL. Supports standard and short TikTok links.
</ParamField>

## Example

<RequestExample>
  ```json theme={null}
  {
    "url": "https://www.tiktok.com/@creator/photo/7499123456789012345"
  }
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "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
    }
  }
  ```
</ResponseExample>

<Note>
  `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.
</Note>

## 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`