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
  • 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

    • warning

      added the new edit_conflict enum value to the response property for the response status

    • warning

      added the new edit_conflict enum value to the response property for the response status

    • warning

      added the new edit_conflict enum value to the response property for the response status

    • warning

      added the new edit_conflict enum value to the response property for the response status

    • warning

      added the new edit_conflict enum value to the response property for the response status

    • warning

      added the new edit_conflict enum value to the response property for the response status

    • warning

      added the new edit_conflict enum value to the response property for the response status

    • warning

      added the new edit_conflict enum value to the response property for the response status

    • warning

      added the new edit_conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new unavailable enum value to the response property for the response status

    • warning

      added the new unavailable enum value to the response property for the response status

    • warning

      added the new unavailable enum value to the response property for the response status

    • warning

      added the new unavailable enum value to the response property for the response status

    • warning

      added the new unavailable enum value to the response property for the response status

    • warning

      added the new unavailable enum value to the response property for the response status

    • warning

      added the new unavailable enum value to the response property for the response status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status