Library

Capture a web page or social post

Captures a public web page or a single post on X, Instagram, LinkedIn or TikTok and saves it to the caller's private library. Pages are captured above the fold; social posts are cropped to their embed card. Set scroll=true to record a scrolling web page as video (ignored for social posts). Returns a finished image or video library item with a sourceId for overlays or layout media. Unlike AI generation, capture completes in this request, with no polling; allow up to two minutes. Private pages and social profiles/feeds are not supported. Use an Idempotency-Key when retrying to avoid duplicate captures.

post/v1/library/screenshots

Request

  • Base URL: https://api.tella.com
  • URL: https://api.tella.com/v1/library/screenshots
  • Auth: HTTP bearer

Request body

scrollboolean

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

urlstring required

Public web page or single post on X, Instagram, LinkedIn or TikTok. A missing scheme defaults to HTTPS.

Response

Captured and saved to the private library

Example response

{
  "item": {
    "category": "Everyday",
    "durationMs": 4200,
    "id": "media_abc123def456",
    "name": "Intro camera take",
    "presetId": "cha-ching"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.