Videos

Search videos

Search the authenticated user's direct video library by title or indexed transcript sentences.

get/v1/videos/search

Request

Base URL: https://api.tella.com
URL: https://api.tella.com/v1/videos/search
Auth: HTTP bearer

Query parameters

querystring required

Words to find in video titles or indexed transcript sentences

searchIn'all' | 'title' | 'transcript'

Fields to search (default: all)

limitinteger

Upper bound on results per page (default: 20, max: 100). A page can be shorter once results the caller cannot see are removed, so keep paging while hasMore is true.

cursorstring

Opaque pagination cursor from the previous response

Response

Matching videos

Example response

{
  "pagination": {
    "hasMore": true,
    "nextCursor": "eyJpZCI6IjEyMyJ9"
  },
  "results": [
    {
      "video": {
        "aspectRatio": "16:9",
        "createdAt": "2024-01-15T10:30:00.000Z",
        "description": "Learn how to create and share your first video",
        "dimensions": {
          "height": 1080,
          "width": 1920
        },
        "id": "vid_abc123def456",
        "links": {
          "embedPage": "https://www.tella.tv/video/vid_abc123def456/embed",
          "viewPage": "https://www.tella.tv/video/vid_abc123def456/view"
        },
        "name": "Getting Started with Tella",
        "updatedAt": "2024-01-15T14:45:00.000Z",
        "views": 1234
      }
    }
  ]
}

Changes

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