> ## Documentation Index > Fetch the complete documentation index at: https://docs.scrapeunblocker.com/llms.txt > Use this file to discover all available pages before exploring further. # Scrape one TikTok video or photo post > Fetches a single public TikTok post by `url` (video URL, photo-post URL, bare id or short link) and returns it as JSON: `id`, `url`, `type` (video/photo), `description`, `title`, `hashtags`, `mentions`, `language`, `createdAt`, exact `stats` (plays, likes, comments, shares, saves, reposts), an `author` snapshot with its own stats, `video` (duration, size, codec, cover, play/download URLs, per-quality URLs, subtitles), `images` for photo posts, `music` (title, author, original, play URL), `flags` (isAd, isAigc, duet/stitch/share enabled), content `labels`, effects and location. With `include_transcript=true` the subtitle track is downloaded too and returned as plain text in `transcript` (with `transcriptLanguage`). Media URLs are signed by TikTok and expire after a few hours. No login or cookies; deleted, private or region-locked posts return 404 with TikTok's reason. ## OpenAPI ````yaml /api-reference/openapi.json post /social/tiktok-video openapi: 3.1.0 info: title: ScrapeUnblocker API description: >- Public API for the ScrapeUnblocker proxy/anti-bot service. Authenticate every request with the `x-scrapeunblocker-key` header. Three endpoints are documented here: page-source extraction, Google SERP scraping, and image fetch. All other paths exist for internal operations and are intentionally hidden from this spec. version: 3.0.0 servers: - url: https://api.scrapeunblocker.com description: Production security: [] paths: /social/tiktok-video: post: tags: - Plugins summary: Scrape one TikTok video or photo post description: >- Fetches a single public TikTok post by `url` (video URL, photo-post URL, bare id or short link) and returns it as JSON: `id`, `url`, `type` (video/photo), `description`, `title`, `hashtags`, `mentions`, `language`, `createdAt`, exact `stats` (plays, likes, comments, shares, saves, reposts), an `author` snapshot with its own stats, `video` (duration, size, codec, cover, play/download URLs, per-quality URLs, subtitles), `images` for photo posts, `music` (title, author, original, play URL), `flags` (isAd, isAigc, duet/stitch/share enabled), content `labels`, effects and location. With `include_transcript=true` the subtitle track is downloaded too and returned as plain text in `transcript` (with `transcriptLanguage`). Media URLs are signed by TikTok and expire after a few hours. No login or cookies; deleted, private or region-locked posts return 404 with TikTok's reason. operationId: tiktok_video_social_tiktok_video_post parameters: - name: url in: query required: true schema: type: string description: >- A TikTok video or photo-post URL ('https://www.tiktok.com/@nasa/video/7665075736742530317'), a bare video id, or a vm.tiktok.com / tiktok.com/t/ short link. title: Url description: >- A TikTok video or photo-post URL ('https://www.tiktok.com/@nasa/video/7665075736742530317'), a bare video id, or a vm.tiktok.com / tiktok.com/t/ short link. - name: include_transcript in: query required: false schema: type: boolean description: >- Also download the video's subtitle track (TikTok's own captions, mostly auto-generated) and return it as plain text in `transcript` - one line per cue. Adds ~1 s. Empty when the video has no subtitle track. default: false title: Include Transcript description: >- Also download the video's subtitle track (TikTok's own captions, mostly auto-generated) and return it as plain text in `transcript` - one line per cue. Adds ~1 s. Empty when the video has no subtitle track. - name: transcript_language in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Preferred subtitle language when several exist, matched against TikTok's codes (e.g. 'eng-US', 'spa-ES', or just 'eng'). Default: the first track. title: Transcript Language description: >- Preferred subtitle language when several exist, matched against TikTok's codes (e.g. 'eng-US', 'spa-ES', or just 'eng'). Default: the first track. - name: proxy_country in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Exit-IP country (ISO-2, e.g. 'US', 'DE'). Optional - TikTok's public pages are the same worldwide; set it only for region-restricted items. title: Proxy Country description: >- Exit-IP country (ISO-2, e.g. 'US', 'DE'). Optional - TikTok's public pages are the same worldwide; set it only for region-restricted items. responses: '200': description: JSON video object. content: application/json: schema: {} '400': description: Missing or malformed url / proxy_country. '404': description: Post was deleted, is private, or is region-locked. '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '502': description: Blocked by TikTok or no post returned. '504': description: Fetch timed out. security: - ScrapeUnblockerKey: [] components: schemas: HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: ScrapeUnblockerKey: type: apiKey in: header name: x-scrapeunblocker-key description: Your ScrapeUnblocker API key. Apply on every request. ````