CODEWITHSUNDEEP
phpyoutubeyoutube-apigoogle-api
Haroldo
Haroldo

Reputation: 37377

YouTube API V3: Where can i find a list of each 'videoCategoryId'?

I'm using the Youtube API V3 but can't find documentation for how to filter by category:

Here's my code:

$results = $youtube->search->listSearch('id,snippet', array(
    'q' =>                  $_GET['q'],
    'maxResults' =>         20,
    'type' =>               'video'
    'videoCategoryId' =>    'what-do-i-put-here?',
));

I've been going through their documentation for an hour and can't seem to find any reference to how I find out what the various category's ids are. In my case I'm looking for the videoCategoryId for music....

Upvotes: 33

Views: 43219

Answers (3)

Alaa Sadik
Alaa Sadik

Reputation: 1089

Using YouTube API v3 video category id list by Dinesh Gowtham Prathap at https://gist.github.com/dgp/1b24bf2961521bd75d6c 

1 - Film & Animation 
2 - Autos & Vehicles
10 - Music
15 - Pets & Animals
17 - Sports
18 - Short Movies
19 - Travel & Events
20 - Gaming
21 - Videoblogging
22 - People & Blogs
23 - Comedy
24 - Entertainment
25 - News & Politics
26 - Howto & Style
27 - Education
28 - Science & Technology
29 - Nonprofits & Activism
30 - Movies
31 - Anime/Animation
32 - Action/Adventure
33 - Classics
34 - Comedy
35 - Documentary
36 - Drama
37 - Family
38 - Foreign
39 - Horror
40 - Sci-Fi/Fantasy
41 - Thriller
42 - Shorts
43 - Shows
44 - Trailers

Upvotes: 58

Ben Simpson
Ben Simpson

Reputation: 427

At the bottom of: https://developers.google.com/youtube/v3/docs/videoCategories/list is a 'try it now' section.

Put 'snippet' in the field labelled 'part' and add a region code, e.g. GB or US in the field labelled 'regionCode'.

This will bring back a full list of categories for your chosen region.

Upvotes: 20

jlmcdonald
jlmcdonald

Reputation: 13667

Video categories are region specific -- that's why the category list service requires either a category ID or a region, but not both. This endpoint:

https://www.googleapis.com/youtube/v3/videoCategories?part=snippet&regionCode={two-character-region}&key={YOUR_API_KEY}

will return all categories, along with their ids, for a given region. So as Ikai Lan pointed out in the comments, the ID for music is '10' in the US and, in fact, in all regions where this category is allowed; but there may be some regions where it isn't allowed, or some regions that aren't supported at all.

Upvotes: 43

Related Questions