InsightSocial APIMedia list
The list shape returned by the YouTube media-file endpoints. A beta, long-tail shape in schema 2.
Endpoints that return a video's files (audio and video streams, subtitle tracks or thumbnails) use this shape.
Beta in schema 2
These endpoints are long-tail: schema 2 does not type their data as an entity. It is the source's own structure under our naming rules (snake_case keys, such as mime_type rather than mimeType, string ids, ISO times where the source gives a timestamp), and its fields may change. They are marked beta in the API reference and can change without a schema version.
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 mime_type, bitrate, quality, width and height, or language. Which details appear depends on the kind of file. Items keep the platform's structure, with snake_case keys; they are not remapped into a unified object. |
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 fields inside each item follow the platform's structure, so there is no per-field availability table. When an endpoint pages, the next page is in pagination.next_cursor; see Pagination.
| 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.