Extract media from a URL

Accepts a public URL and returns variants. Video and audio may arrive separately.

Request body

Field	Type	Description
url	string	Required. Public URL of the post or video.
prefer	string	Optional, best-effort, maxLength 20. Unknown values degrade silently.
download_links	boolean	Optional. false does not emit download_url.

url

string

Required. Public URL of the post or video.

prefer

string

Optional, best-effort, maxLength 20. Unknown values degrade silently.

download_links

boolean

Optional. false does not emit download_url.

requires_mux is a response field. If true, call POST /v1/assemble; ignoring it yields silent YouTube video.

request

{
  "url": "https://example.invalid/x/status/1"
}

200 response

{
  "ok": true,
  "items": [
    {
      "variants": [
        { "type": "video", "resolution": "1080p", "has_audio": false },
        { "type": "audio", "has_audio": true }
      ],
      "requires_mux": true,
      "download_url": "https://EDGE_BASE_URL/dl/{token}",
      "expires_at": "2026-09-04T18:22:00Z"
    }
  ]
}