POST
/
batch
/
channels
curl --request POST \
  --url https://api.poix.io/batch/channels \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "ids": [
    "UCuAXFkgsw1L7xaCfnd5JJOw",
    "UC0C-w0YjGpqDXGB8IHb662A",
    "UCSY5V7BJSrxNvvBF0Drslow",
    "UCBVjMGOIkavEAhyqpxJ73Dw",
    "UCi4EDAgjULwwNBHOg1aaCig"
  ]
}'
{
  "totalResults": 1,
  "data": [
    {
      "id": "UCuAXFkgsw1L7xaCfnd5JJOw",
      "title": "Rick Astley",
      "description": "'Free' Remaster out now!",
      "keywords": "Official Rick Astley \"rick astley\" \"never gonna give you up\" \"the best of me\" \"best of me\" \"together forever\" \"cry for help\" \"beautiful life\" \"official video\" \"official audio\" rickroll rickrolled \"rick roll\" \"rick asltey\" \"give up\" meme",
      "unsubscribedTrailer": "mIHHfNVfhPk",
      "country": "GB",
      "customUrl": "@rickastleyyt",
      "publishedAt": "2015-02-01T16:32:30Z",
      "thumbnails": {
        "default": {
          "url": "https://yt3.ggpht.com/coJBIm7rugfAkdb9_cw5Lry2NDnfSYDjL5MBu_R2st_YCLsZtDxYu28h2EAJzPfY8qudaF8U=s88-c-k-c0x00ffffff-no-rj",
          "width": 88,
          "height": 88
        },
        "medium": {
          "url": "https://yt3.ggpht.com/coJBIm7rugfAkdb9_cw5Lry2NDnfSYDjL5MBu_R2st_YCLsZtDxYu28h2EAJzPfY8qudaF8U=s240-c-k-c0x00ffffff-no-rj",
          "width": 240,
          "height": 240
        },
        "high": {
          "url": "https://yt3.ggpht.com/coJBIm7rugfAkdb9_cw5Lry2NDnfSYDjL5MBu_R2st_YCLsZtDxYu28h2EAJzPfY8qudaF8U=s800-c-k-c0x00ffffff-no-rj",
          "width": 800,
          "height": 800
        }
      },
      "viewCount": "2100929381",
      "subscriberCount": "4160000",
      "hiddenSubscriberCount": false,
      "videoCount": "265",
      "topicIds": [
        "/m/04rlf",
        "/m/0gywn",
        "/m/06by7",
        "/m/064t9"
      ],
      "topicCategories": [
        "https://en.wikipedia.org/wiki/Music",
        "https://en.wikipedia.org/wiki/Soul_music",
        "https://en.wikipedia.org/wiki/Rock_music",
        "https://en.wikipedia.org/wiki/Pop_music"
      ],
      "relatedPlaylists": {
        "likes": "",
        "uploads": "UUuAXFkgsw1L7xaCfnd5JJOw"
      },
      "privacyStatus": "public",
      "isLinked": true,
      "longUploadsStatus": "longUploadsUnspecified",
      "madeForKids": false,
      "bannerExternalUrl": "https://yt3.googleusercontent.com/KBtTGhBjiM4CD9oUrQke85BALlD1Tt-QFh_AQqzJIQJXFUQt1mtS6jJjIJkQDEbphga9O1Kt",
      "thumbnailUrl": "https://yt3.ggpht.com/coJBIm7rugfAkdb9_cw5Lry2NDnfSYDjL5MBu_R2st_YCLsZtDxYu28h2EAJzPfY8qudaF8U=s240-c-k-c0x00ffffff-no-rj"
    }
  ]
}

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:
en,
es,
de,
fr,
ja,
pt,
tr,
it,
fa,
nl,
af,
am,
ar,
as,
az,
be,
bg,
bn,
bs,
ca,
cs,
da,
el,
en-GB,
en-IN,
es-419,
es-US,
et,
eu,
fi,
fil,
fr-CA,
gl,
gu,
hi,
hr,
hu,
hy,
id,
is,
iw,
ka,
kk,
km,
kn,
ko,
ky,
lo,
lt,
lv,
mk,
ml,
mn,
mr,
ms,
my,
no,
ne,
or,
pa,
pl,
pt-PT,
ro,
ru,
si,
sk,
sl,
sq,
sr-Latn,
sr,
sv,
sw,
ta,
te,
th,
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.

​
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

200
application/json
Successful response
​
totalResults
number
required

The total number of channels returned

​
data
object[]
required