InsightSocial APIUnified schema
Media list
The list shape returned by the YouTube media-file endpoints, with each file's own technical fields kept as-is.
Endpoints that return a video's files (audio and video streams, subtitle tracks or thumbnails) use this shape.
Fields
| Field | Type | Nullable | Description |
|---|---|---|---|
items | object[] | No | The files for the video. Each item has the file's direct url plus its own technical details, such as mimeType, bitrate, quality, width and height, or language. Which details appear depends on the kind of file. Items are passed through as the platform describes them, not remapped into a unified object. |
next_cursor | string | Yes | Cursor for the next page, on endpoints that page. Present only when there are more results. |
total | integer | Yes | Total number of results, when the platform reports one. Left out otherwise. |
Where it is used
Only YouTube returns this shape, on four endpoints. The outer fields above are always there; the fields inside each item are kept exactly as the platform sends them, so there is no per-field availability table.
| Platform | Endpoints |
|---|---|
| YouTube | /v1/youtube/video/audio, /v1/youtube/video/files, /v1/youtube/video/subtitles, /v1/youtube/video/thumbnails |
See YouTube for the rest of the platform's endpoints.