Get videos details

curl --request GET \
  --url https://api.poix.io/videos \
  --header 'Authorization: Bearer <token>'

{
  "totalResults": 123,
  "data": [
    {
      "id": "<string>",
      "publishedAt": "<string>",
      "channelId": "<string>",
      "title": "<string>",
      "description": "<string>",
      "thumbnails": {
        "default": {
          "url": "<string>",
          "width": 123,
          "height": 123
        },
        "medium": {
          "url": "<string>",
          "width": 123,
          "height": 123
        },
        "high": {
          "url": "<string>",
          "width": 123,
          "height": 123
        }
      },
      "channelTitle": "<string>",
      "tags": [
        "<string>"
      ],
      "categoryId": "<string>",
      "defaultLanguage": "<string>",
      "defaultAudioLanguage": "<string>",
      "viewCount": "<string>",
      "likeCount": "<string>",
      "commentCount": "<string>",
      "topicCategories": [
        "<string>"
      ],
      "uploadStatus": "<string>",
      "privacyStatus": "<string>",
      "license": "<string>",
      "embeddable": true,
      "publicStatsViewable": true,
      "madeForKids": true,
      "hasPaidProductPlacement": true,
      "localizations": {},
      "categoryTitle": "<string>",
      "duration": "<string>",
      "parsedDuration": 123,
      "captionsUrl": "<string>",
      "videoFileUrl": "<string>",
      "audioFileUrl": "<string>"
    }
  ]
}

GET

videos

Get videos details

curl --request GET \
  --url https://api.poix.io/videos \
  --header 'Authorization: Bearer <token>'

{
  "totalResults": 123,
  "data": [
    {
      "id": "<string>",
      "publishedAt": "<string>",
      "channelId": "<string>",
      "title": "<string>",
      "description": "<string>",
      "thumbnails": {
        "default": {
          "url": "<string>",
          "width": 123,
          "height": 123
        },
        "medium": {
          "url": "<string>",
          "width": 123,
          "height": 123
        },
        "high": {
          "url": "<string>",
          "width": 123,
          "height": 123
        }
      },
      "channelTitle": "<string>",
      "tags": [
        "<string>"
      ],
      "categoryId": "<string>",
      "defaultLanguage": "<string>",
      "defaultAudioLanguage": "<string>",
      "viewCount": "<string>",
      "likeCount": "<string>",
      "commentCount": "<string>",
      "topicCategories": [
        "<string>"
      ],
      "uploadStatus": "<string>",
      "privacyStatus": "<string>",
      "license": "<string>",
      "embeddable": true,
      "publicStatsViewable": true,
      "madeForKids": true,
      "hasPaidProductPlacement": true,
      "localizations": {},
      "categoryTitle": "<string>",
      "duration": "<string>",
      "parsedDuration": 123,
      "captionsUrl": "<string>",
      "videoFileUrl": "<string>",
      "audioFileUrl": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

ids

string

required

An array of video IDs to retrieve data for.

enum<string>

The language to retrieve localized data in.

Available options:

af,

am,

ar,

as,

az,

be,

bg,

bn,

bs,

ca,

cs,

da,

de,

el,

en-GB,

en-IN,

en,

es,

es-419,

es-US,

et,

eu,

fa,

fi,

fil,

fr-CA,

fr,

gl,

gu,

hi,

hr,

hu,

hy,

id,

is,

it,

iw,

ja,

ka,

kk,

km,

kn,

ko,

ky,

lo,

lt,

lv,

mk,

ml,

mn,

mr,

ms,

my,

no,

ne,

nl,

or,

pa,

pl,

pt,

pt-PT,

ro,

ru,

si,

sk,

sl,

sq,

sr-Latn,

sr,

sv,

sw,

ta,

te,

th,

tr,

uk,

ur,

uz,

vi,

zh-CN,

zh-HK,

zh-TW,

zu

fields

string

An array of fields to include in the response. If not provided, all fields will be returned.

Response

Successful response

totalResults

number

required

Total number of video details returned.

data

object[]

required

Array of video detail objects.

Show child attributes

data.id

string

required

The unique ID of the video.

data.publishedAt

string

The date and time when the video was published.

data.channelId

string

The ID of the channel that owns the video.

data.title

string

The title of the video.

data.description

string

The description of the video.

data.thumbnails

object

The thumbnails for the video, available in different sizes.

Show child attributes

data.thumbnails.default

object

required

Show child attributes

data.thumbnails.default.url

string

required

The URL of the thumbnail image.

data.thumbnails.default.width

number

required

The width of the thumbnail image.

data.thumbnails.default.height

number

required

The height of the thumbnail image.

data.thumbnails.medium

object

required

Show child attributes

data.thumbnails.medium.url

string

required

The URL of the thumbnail image.

data.thumbnails.medium.width

number

required

The width of the thumbnail image.

data.thumbnails.medium.height

number

required

The height of the thumbnail image.

data.thumbnails.high

object

required

Show child attributes

data.thumbnails.high.url

string

required

The URL of the thumbnail image.

data.thumbnails.high.width

number

required

The width of the thumbnail image.

data.thumbnails.high.height

number

required

The height of the thumbnail image.

data.channelTitle

string

The title of the channel that owns the video.

data.tags

string[]

An array of tags associated with the video.

data.categoryId

string

The ID of the category the video belongs to.

data.defaultLanguage

string

The default language of the video.

data.defaultAudioLanguage

string

The default audio language of the video.

data.viewCount

string

The number of views the video has received.

data.likeCount

string

The number of likes the video has received.

data.commentCount

string

The number of comments on the video.

data.topicCategories

string[]

An array of topic categories associated with the video.

data.uploadStatus

string

The upload status of the video.

data.privacyStatus

string

The privacy status of the video.

data.license

string

The license type of the video.

data.embeddable

boolean

Indicates if the video can be embedded.

data.publicStatsViewable

boolean

Indicates if the video statistics are publicly viewable.

data.madeForKids

boolean

Indicates if the video is made for kids.

data.hasPaidProductPlacement

boolean

Indicates if the video has paid product placement.

data.localizations

object

Localized titles and descriptions for the video.

Show child attributes

data.localizations.{key}

object

Show child attributes

data.localizations.{key}.title

string

required

The localized title of the video.

data.localizations.{key}.description

string

required

The localized description of the video.

data.categoryTitle

string

The title of the category the video belongs to.

data.duration

string

The duration of the video.

data.parsedDuration

number

The parsed duration of the video in seconds.

data.captionsUrl

string

The URL for the video captions, if available.

data.videoFileUrl

string

The URL for the video file, if available.

data.audioFileUrl

string

The URL for the audio file, if available.

Get channels details Get playlist items

⌘I

API Documentation

Search

Batch

Details

General

Files

Get videos details

Authorizations

Query Parameters

Response