Get Media

View Markdown

Get a media object by ID.


GET
/media/{id}

Authorization

AuthorizationRequiredBearer <token>

See API Security for more details.

In: header

Path Parameters

idRequiredstring

Header Parameters

Accept-Versionstring

Specifies the API Version

Default: "2025-08-20"Value in: "2025-08-20" | "latest"

Response Body

Success

idRequiredstring
objectRequiredstring
kindstring
Value in: "video" | "image" | "audio"
titlestring
altstring
widthinteger
heightinteger
durationnumber
Format: "float"
filesRequiredarray<object>
urlsRequiredobject
backgroundstring
metadataobject
createdRequiredstring
Format: "date-time"
updatedRequiredstring
Format: "date-time"
const media = await fetch("https://api.ittybit.com/media/med_abcdefgh1234", {
  headers: { "Authorization": "Bearer ITTYBIT_API_KEY" }
})
{
  "id": "med_abcdefgh1234",
  "object": "media",
  "kind": "video",
  "title": "My Video Example",
  "alt": "An example video used to demonstrate the ittybit API",
  "width": 1920,
  "height": 1080,
  "duration": 123.45,
  "files": [
    {
      "id": "file_abcdefgh1234",
      "object": "source",
      "kind": "video",
      "format": "mp4",
      "type": "video/mp4; codecs=\"avc1.6431, mp4a.40.2\"",
      "width": 1920,
      "height": 1080,
      "duration": 123.45,
      "filesize": 12345678,
      "folder": "example",
      "filename": "video.mp4",
      "url": "https://you.ittybit.net/example/video.mp4",
      "ref": "original",
      "created": "2025-01-01T01:23:45Z",
      "updated": "2025-01-01T01:23:45Z"
    },
    {
      "id": "file_abcdefgh5678",
      "object": "source",
      "kind": "image",
      "format": "png",
      "type": "image/png",
      "width": 640,
      "height": 360,
      "filesize": 123456,
      "folder": "example",
      "filename": "image.png",
      "url": "https://you.ittybit.net/example/image.png",
      "ref": "thumbnail",
      "created": "2025-01-01T01:23:46Z",
      "updated": "2025-01-01T01:23:46Z"
    }
  ],
  "urls": {
    "original": "https://you.ittybit.net/example/video.mp4",
    "thumbnail": "https://you.ittybit.net/example/image.png"
  },
  "background": "#2OBO75",
  "metadata": {
    "customKey": "your custom value"
  },
  "created": "2025-01-01T01:23:45Z",
  "updated": "2025-01-01T01:23:46Z"
}