Skip to main content
In this example, we will show how to retrieve data for multiple YouTube channels using the Poix.io API batch request endpoint. The batch request endpoint allows you to fetch data for up to 1,000 channels in a single request. This can be useful when you need to retrieve data for multiple channels at once, such as when building a dashboard or analytics tool. Often can be used after requestiong search results or popular videos.

​
Request examples

const options = {
  method: 'POST',
  headers: {
    Authorization: 'Bearer poix-xxx',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ ids: ['UCuAXFkgsw1L7xaCfnd5JJOw'] }),
};

fetch('https://api.poix.io/batch/channels', options)
  .then((response) => response.json())
  .then((response) => console.log(response))
  .catch((err) => console.error(err));
In this request, we are fetching data for the YouTube channel with the ID UCuAXFkgsw1L7xaCfnd5JJOw. You can provide multiple channel IDs in the ids array.

​
Response example

{
  "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": "4170000",
      "hiddenSubscriberCount": false,
      "videoCount": "268",
      "topicIds": ["/m/06by7", "/m/04rlf", "/m/064t9", "/m/0gywn"],
      "topicCategories": [
        "https://en.wikipedia.org/wiki/Rock_music",
        "https://en.wikipedia.org/wiki/Music",
        "https://en.wikipedia.org/wiki/Pop_music",
        "https://en.wikipedia.org/wiki/Soul_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"
    }
  ]
}
In this response, we are fetching data for the YouTube channel with the ID UCuAXFkgsw1L7xaCfnd5JJOw. The response includes information such as the channel title, description, keywords, country, custom URL, published date, thumbnails, view count, subscriber count, video count, topic IDs, topic categories, related playlists, privacy status, and more. Get more details about this API endpoint in the Get batch channels documentation.
⌘I