Skip to main content
POST
/
batch
/
channels
Get batch channels
curl --request POST \
  --url https://api.poix.io/batch/channels \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ids": [
    "<string>"
  ],
  "includeLocalizations": false
}
'
{
  "totalResults": 123,
  "data": [
    {
      "id": "<string>",
      "title": "<string>",
      "description": "<string>",
      "keywords": "<string>",
      "unsubscribedTrailer": "<string>",
      "country": "<string>",
      "customUrl": "<string>",
      "publishedAt": "<string>",
      "viewCount": "<string>",
      "subscriberCount": "<string>",
      "hiddenSubscriberCount": true,
      "videoCount": "<string>",
      "topicIds": [
        "<string>"
      ],
      "topicCategories": [
        "<string>"
      ],
      "relatedPlaylists": {
        "likes": "<string>",
        "uploads": "<string>"
      },
      "privacyStatus": "<string>",
      "isLinked": true,
      "longUploadsStatus": "<string>",
      "madeForKids": true,
      "bannerExternalUrl": "<string>",
      "thumbnailUrl": "<string>",
      "thumbnails": {
        "default": {
          "url": "<string>",
          "width": 123,
          "height": 123
        },
        "medium": {
          "url": "<string>",
          "width": 123,
          "height": 123
        },
        "high": {
          "url": "<string>",
          "width": 123,
          "height": 123
        }
      }
    }
  ]
}
This endpoint allows you to retrieve multiple channels in a single request. Simply specify a list of channel IDs, and the API will return the details of each channel.
This request supports batch processing, allowing you to retrieve up to 1,000 channels in a single request.

​
Price

The cost of this request is based on the number of channel chunks (by 50 channels) in the request. For example:
  • 1 channel means 1 chunk
  • 50 channels means 1 chunk
  • 75 channels means 2 chunks
  • 100 channels means 2 chunks
  • 101 channels means 3 chunks
  • 1000 channels means 20 chunks

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
hl
enum<string>

The language code (e.g., "en-US", "es") to retrieve localized data in. If not specified, the default language of the channel is used.

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

A comma-separated list of fields to include in the response. If not provided, all fields will be returned.

Body

application/json
​
ids
string[]
required

An array of channel IDs to retrieve data for. Each ID should be a valid 24-character channel ID. Minimum 1, maximum 1000 IDs.

Required array length: 1 - 1000 elements
Required string length: 24
​
includeLocalizations
boolean
default:false

Whether to include localized data for the channel. If true, localized fields will be returned in the specified language (hl parameter). Default is false.

Response

Successful response

​
totalResults
number
required

The total number of channels returned

​
data
object[]
required