Skip to main content
POST
Import media from a URL

Authorizations

Authorization
string
header
required

API key obtained from your Tella account settings

Body

application/json
url
string
required

A public web page, a single post on X, Instagram, LinkedIn or TikTok, or a link to a single video on YouTube, X, Instagram or TikTok. A missing scheme defaults to HTTPS.

Minimum string length: 1
Example:

"https://tella.com"

scroll
boolean

Record a scrolling web page as video instead of a still (default false). Ignored for social posts and video links.

video
boolean

Omit to download every video link, and X and Instagram /p/ posts that hold a video. false captures the link's page or card instead; true downloads a post without checking first that it holds one.

videoId
string

Save into this video's own library instead of your private library. You must be able to edit it. Required for video downloads.

Example:

"vid_abc123def456"

Response

Captured and saved to the library

import
object
required