WIwithchima
Library

Import media from a URL

Changed on

Brings media into Tella from a link. A public web page is captured above the fold at 1920×1080 (or, with scroll=true, recorded scrolling as video); a single post on X, Instagram, LinkedIn or TikTok is cropped to its embed card. These finish in this request (allow up to two minutes) and answer 201 with status: completed. A link to a single video is downloaded in the background and answers 202 with status: running: poll GET /v1/library/imports/{id}?videoId=… every 5-10 seconds until it is completed or failed. Video links need videoId and land in that video's library; everything else lands in your private library unless you pass videoId. Place item.sourceId as an overlay or layout media. Only import media you own or have the rights to use. Private pages, social profiles and feeds, and private, members-only or age-restricted videos are not supported. Use an Idempotency-Key when retrying to avoid duplicate imports.

post/v1/library/imports

Request

Request body

scrollboolean

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

urlstring 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.

videoboolean

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.

videoIdstring

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

Example request

{
  "url": "https://tella.com",
  "videoId": "vid_abc123def456"
}

Response

Captured and saved to the library

Example response

{
  "import": {
    "id": "mi_abc123def456",
    "item": {
      "category": "Everyday",
      "durationMs": 4200,
      "id": "media_abc123def456",
      "name": "Intro camera take",
      "presetId": "cha-ching",
      "scope": "private",
      "sourceId": "su_abc123def456",
      "type": "video"
    }
  }
}

Changes

  • e6d5eb99c711Revision changes
    • warning

      added the new vintage enum value to the ////// response property for the response status

    • warning

      added the new vintage enum value to the ////// response property for the response status

  • 6c042ab0bd1aRevision changes
    • info

      added the new optional request property