# TikTok Video

Resolve a TikTok video, photo post, short URL, or raw video ID into metadata and playback URLs from the configured RapidAPI upstream.

- **Documentation:** [https://scrappa.co/docs/tiktok/tiktok_video](https://scrappa.co/docs/tiktok/tiktok_video)
- **API group:** TikTok API
- **Endpoint:** `GET https://scrappa.co/api/tiktok/video`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | Yes | TikTok video URL, short URL, photo URL, or raw video ID. |
| `hd` | boolean | No | Request the HD playback URL when available. Accepts true/false or 1/0. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/tiktok/video?url=https%3A%2F%2Fwww.tiktok.com%2F%40tiktok%2Fvideo%2F7568510388342443294&hd=1"
```

## Example response

```json
{
    "code": 0,
    "msg": "success",
    "data": {
        "title": "Example TikTok",
        "play": "https://example.com/play.mp4",
        "wmplay": "https://example.com/wmplay.mp4",
        "hdplay": "https://example.com/hdplay.mp4"
    }
}
```

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)