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

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 | Region of the proxy. Sometimes you'll need to specify the region if you're not getting a response. Commonly for videos from the Phillipines, in which case you'd use 'PH'. Use 2 letter country codes like US, GB, FR, etc |
| `trim` | no | Set to true to get a trimmed response |
| `download_media` | no | Set to true to also download the video/images and get back permanent, durable 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. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/tiktok/post?url=https%3A%2F%2Fwww.tiktok.com%2F%40charlidamelio%2Fvideo%2F7321485815660738859" \
  -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 Supabase-hosted URLs for the video and images. Media downloads cost 10 credits when media is found and 1 credit otherwise.

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

Standard requests cost 1 credit. With download_media=true it is 10 credits if media is found, 1 credit otherwise. 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?