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

Response

200
application/json

Successful response

The response is of type object.