Skip to main content
POST
Get metadata
The result is the source’s own metadata in snake_case, so which fields exist depends on the platform. The most useful ones are listed on Metadata. If you only need the title, duration, and thumbnail, basic metadata is faster.
The stream url inside each entry of formats is short-lived and often tied to the IP that fetched it. Download with POST /import instead of fetching it yourself.
Poll the result with GET /metadata/status, or receive it by webhook.

Authorizations

Authorization
string
header
required

Your API key from the dashboard, sent as Authorization: Bearer <api key>.

Body

application/json
url
string<uri>
required

Public media page URL, e.g. a YouTube, TikTok or podcast episode link.

Example:

"https://www.youtube.com/watch?v=jNQXAC9IVRw"

webhookUrl
string<uri>

HTTPS URL that receives the result when the job finishes. It must not point to a private or internal address. A job that fails for good sends one webhook with success: false, code and message.

Example:

"https://example.com/webhooks/importly"

Response

The metadata job was queued.

success
boolean
required
data
object
required