Skip to main content
Use metadata to show a link preview, check a video’s length before you pay to download it, or pick the right quality. There are two endpoints, and both cost $0.01 and never download the media.

Quick start

Like every endpoint, metadata runs as a job. Poll GET /metadata/basic/status?id={jobId} (or /metadata/status for full metadata), or pass a webhookUrl:

Full metadata fields

Full metadata is the source’s own data in snake_case, so which fields exist depends on the platform. A YouTube result has about 80 fields. These are the ones most apps use:
Each entry in formats has the platform’s own stream url. Those URLs are short-lived and often tied to the IP that fetched them, so they usually fail from your server. Download with POST /import instead.

Without a webhook

Both endpoints also accept GET with the URL as a query parameter, for example GET /metadata/basic?url=https://www.youtube.com/watch?v=jNQXAC9IVRw. The GET form can’t take a webhookUrl, so poll for the result.

Pricing

$0.01 per request for either endpoint. Status checks are free. See Pricing & credits.

Reference: POST /metadata

Full metadata, with an abridged real response.

Reference: POST /metadata/basic

Title, duration, and thumbnail.