# TikTok Post API (https://www.socialcrawl.dev/platforms/tiktok/post)

> Returns detailed information about a specific TikTok video including view count, like count, comment count, share count, caption, music info, author details, and video metadata. When the creator added on-screen text with TikTok's built-in text tool, the overlay text is returned in `data.post.ext.on_screen_texts` (absent when the video has none: text burned in with an external editor is not detectable from post data).

TL;DR: `GET /v1/tiktok/post` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | Full URL of the TikTok video |
| `region` | no | Two-letter country code for the proxy region (US, GB, FR, PH). The primary source does not take a region, so it is honoured only when a fallback source serves the request; a region-locked video (commonly from the Philippines) that fails on the primary is retried on the fallback with this value. |
| `trim` | no | Accepted for compatibility; the response is already the canonical shape, so this flag has no effect. |
| `download_media` | no | Set to true to also download the video/images and get back durable hosted media URLs under `data.post.ext.download_media_urls` (`[{ post_id, cdn_url, type, cached }]`). Use these for archiving; the raw `media_urls` are short-lived signed CDN links that expire. Adds a few seconds of latency while the media is fetched. Availability is source-dependent and most responses will not carry it: when the serving source cannot host durable copies the field is absent, the response carries a `data._warnings` note saying so, and `data.post.content.media_urls` still carries the media. |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/tiktok/post" \
  --data-urlencode "url=https://www.tiktok.com/@stoolpresidente/video/7623818255903329566" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get TikTok video details with an API?

Send a GET request to /v1/tiktok/post with the full video URL in the url parameter. SocialCrawl returns view count, like count, comment count, share count, caption, music info, author details, and video metadata in a unified schema.

### Can I download the TikTok video file directly?

Yes. Pass download_media=true to receive permanent, durable URLs for the video and images, so you are not storing short-lived CDN links. It costs no extra credits, though the call takes a few seconds longer while the media is fetched.

### Can I get the TikTok transcript in the same call?

Yes. Pass get_transcript=true to include the video transcript in the response. This uses the profile cache category and avoids a second request to /v1/tiktok/post/transcript.

### Why do some TikTok videos return empty responses?

Some videos are region-locked. Pass the region parameter with a 2-letter country code (e.g., PH for the Philippines) to route the proxy through that region. Use GB for England, not UK.

### How much does the TikTok Video API cost?

Every request costs 1 credit, including when you pass download_media=true. New accounts get 100 free credits with no credit card required.

See the full TikTok API: https://www.socialcrawl.dev/platforms/tiktok

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to get TikTok video details with the SocialCrawl API
- Can SocialCrawl return TikTok video download URLs?