> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stophy.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# TikTok video

> Read a TikTok video page or share link as JSON with the tiktok-video parser. $1 per 1,000 calls. Send the page to scrape.

Reads a TikTok video page or share link and returns one video as JSON.

## Make a request

Send the page's URL to [scrape](https://docs.stophy.dev/api-reference/endpoint/scrape.md) with a `json` format that names the parser. Get an API key in the [Quickstart](https://docs.stophy.dev/quickstart).

```bash cURL theme={null}
curl -X POST https://api.stophy.dev/v1/scrape \
  -H "Authorization: Bearer $STOPHY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.tiktok.com/@charlidamelio/video/7137423965982592302","formats":[{"type":"json","parser":"tiktok-video"}]}'
```

```typescript TypeScript theme={null}
const response = await fetch("https://api.stophy.dev/v1/scrape", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.STOPHY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    url: "https://www.tiktok.com/@charlidamelio/video/7137423965982592302",
    formats: [{ type: "json", parser: "tiktok-video" }],
  }),
});
console.log(await response.json());
```

```python Python theme={null}
import os

import requests

response = requests.post(
    "https://api.stophy.dev/v1/scrape",
    headers={"Authorization": f"Bearer {os.environ['STOPHY_API_KEY']}"},
    json={
        "url": "https://www.tiktok.com/@charlidamelio/video/7137423965982592302",
        "formats": [{"type": "json", "parser": "tiktok-video"}],
    },
)
print(response.json())
```

## Read the response

The parser's data is in `data.json`. Its fields include `id`, `url`, `title`, `description`, `author`, `publishedAt`, `durationSeconds`, `views`, `likes`, `comments`, `thumbnailUrl` and `hashtags`. This sample is cut to the first items.

```json theme={null}
{
  "success": true,
  "data": {
    "json": {
      "id": "7137423965982592302",
      "url": "https://www.tiktok.com/@charlidamelio/video/7137423965982592302",
      "title": null,
      "description": null,
      "author": {
        "id": "5831967",
        "name": "charli d’amelio",
        "handle": "charlidamelio",
        "url": "https://www.tiktok.com/@charlidamelio",
        "avatarUrl": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ee31de49ddf64b45c5b2e3c55fbd0ea4~tplv-tiktokx-cropcenter:7…",
        "isVerified": true
      },
      "publishedAt": "2022-08-29T22:10:18.000Z",
      "durationSeconds": 11,
      "views": 22000000,
      "likes": 2100000,
      "comments": 19000,
      "thumbnailUrl": "https://p16-common-sign.tiktokcdn-eu.com/tos-useast5-p-0068-tx/c1844bce7c5a4b07b0e4ae2301a1996a~tplv-tiktokx-origin.ima…",
      "hashtags": [],
      "type": "video",
      "mentions": [],
      "imageUrls": [],
      "shares": 17300,
      "saves": 83186,
      "audioId": "7090403288818584347",
      "audioTitle": "Streets x Kiss it better",
      "audioArtist": ":p",
      "audioIsOriginal": true,
      "isAd": false,
      "isAiGenerated": false,
      "country": "US",
      "downloadUrl": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/f7803ec144cb492986bb4b6056003a3c/?a=1988&bti…",
      "watermarkedDownloadUrl": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/0641e3a6387a49e4a2c8c4de2c457fe8/?a=1988&bti…",
      "downloadExpiresAt": "2026-11-06T23:11:21.000Z",
      "downloadHeaders": {
        "referer": "https://www.tiktok.com/",
        "cookie": "<cookie>"
      },
      "audioUrl": "https://v45.tiktokcdn-eu.com/852d1747fbc73b4bca955665607a30e5/6aed0d19/video/tos/no1a/tos-no1a-v-2370c710-no/1643bebb34…",
      "width": 576,
      "height": 1024,
      "quality": "540p"
    }
  }
}
```

## Options

This parser takes no options.

## Price

\$1 per 1,000 calls. See [Pricing](https://docs.stophy.dev/account/pricing.md).

## Limits and errors

* The URL must be a TikTok video page or share link. Any other URL fails with `invalidRequest`.
* The answer comes back in `data.json`. If the page cannot be read, the call fails with an error code from [Errors](https://docs.stophy.dev/api-reference/errors.md).

## Related

* [Pre-built parsers](https://docs.stophy.dev/scrape/prebuilt-parsers) lists every parser.
* [Scrape](https://docs.stophy.dev/scrape/overview) has the options every scrape takes.
* [TikTok comments](https://docs.stophy.dev/scrape/prebuilt-parsers/video/tiktok-comments.md)
* [TikTok transcript](https://docs.stophy.dev/scrape/prebuilt-parsers/video/tiktok-transcript.md)
* [TikTok profile](https://docs.stophy.dev/scrape/prebuilt-parsers/video/tiktok-profile.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.