GET /v1/metadata returns structured metadata for any supported public video URL. This is a free endpoint — it consumes zero credits — so you can use it to inspect a video before deciding whether to run a transcript or extraction job on it.
Endpoint
Authentication
This endpoint requires anx-api-key header.
Parameters
string
required
The full public video URL. Supported platforms: YouTube, TikTok, Instagram, X/Twitter, and Facebook.
Example
Response
string
The video’s title as it appears on the platform.
string
The display name of the channel or account that published the video.
string
The platform the video was fetched from — e.g.
youtube, tiktok, instagram.number
Video length in seconds.
number
Total view count as reported by the platform.
number
Total like count as reported by the platform.
string
URL of the video’s thumbnail image.
This is a free endpoint — 0 credits consumed. Use it to validate URLs or gather basic stats before committing credits to a transcript or extract job.