Vídeos de K-Pop no Youtube

Disclaimer: Database download offered for free, we do not offer support on how to handle it, but if you find a bug in the JSON/Download feel free to report.

API

With our API you can fetch data from videos or artists and get the result in JSON. Special characters are treated into ampersant character codes

The API is meant for dinamic data check. For fixed data such as published date and relation between groups and MVS or other data, as well all database, use the database download
There are two commands: listVideos and listArtists.

API access: http://www.aoimirai.net/kpop/api.php?command=[command]&[parameters]

Note that it makes no sense to request data more often than each 12 hours, since the top recent/views is updated each 12 hours, video data takes almost 3 days to be fully updated, and followers data can take up to a week to be fully updated. To enforce that, we will throttle requests from the same IP if above 12 a day.

For more detailed and complete data, download the actual database

COMMON PARAMETERS:

format can be "json" or "html". If HTML, it will return a table ready to be displayed on your site (use an iframe for that, the table is adjusted for 100% space horizontal, and is around 600px height). Default: json
bgcolor is used when returning html and defines the RGB color of the background, valid values are 6 digit RGB like f0f0f0. Default: fefefe
txtcolor is used when returning html and defines the RGB color of the text. Default is 101010
Note: if you can't handle the results or coding with it, please don't ask us for help, we are already providing the full database FREE


Commands

For listVideos, you can set the following parameters:

listType (mandatory): topViews, topLikes or topRVD
Sets the type of list returned.
topViews returns the top 30 videos by views;
topLikes returns the top 30 videos by likes;
topRVD returns the top 30 videos by recent View/day.
filterGroup (optional) will return videos only from the specied artist id (you can check the artist ids on the listArtists)

filterType (optional, if not set returns all) will filter only group or solo

filterGender (optional, if not set returns all) will filter only male, female or coed

includeVideos (optional, if not set returns all) is a 3 character string of '0' or '1' (example: 111) with '1' meaning you want a specific type of video, in order: Duplicates, Alternates, Dance. So if you send "100" you will get only Duplicates (and mains, always)

The return is a JSON list with each item containing:
artistName - Name of the artist/group
musicName - Name of the music
views - Number of views
likes - number of likes
RVD - Recent view/day
link - Youtube video code
videoType - Type of video (main, duplicate, alternate or dance)
isDead - Returns 'y' or 'n' if the video has been removed from Youtube

For listArtists, you can set the following parameters:

listType (mandatory): topViews, topLikes, topRVD or topFollowers
Sets the type of list returned.
topViews returns the top 10 artists by total views;
topLikes returns the top 10 artists by total likes;
topRVD returns the top 10 artists by total recent View/day;
topFollowers returns the top 10 artists by total followers (vLive, Facebook, Twitter, Instagram and Youtube).
filterType (optional, if not set returns all) will filter only group or solo

filterGender (optional, if not set returns all) will filter only male, female or coed

includeVideos (optional, if not set returns all) is a 3 character string of '0' or '1' (example: 111) with '1' meaning you want a specific type of video, in order: Duplicates, Alternates, Dance. So if you send "100" you will get only Duplicates (and mains, always)

The return is a JSON list with each item containing:
artistName - Name of the artist/group
artistNameKorean - Name of artist in korean
views - Number of total views
likes - number of total likes
RVD - Recent view/day
followersTotal - Total followers
followersVLive - Followers on vLive
followersTwitter - Followers on Twitter
followersFacebook - Followers on Facebook
followersInstagram - Followers on Instagram
followersYoutube - Followers on Youtube
mediaLinks - comma separated list of the username/code/url for each social media or site (K = Wikipedia, W = Website, V = vLive Channel, VS = vLive id, T = Twitter username, F = Facebook username, I = Instagram name, Y = Youtube CHANNEL, U = Youtube User)
sales - sales up to the latest GAON monthly report, with some pre-GAON (MIAK) sales data

Example and test

In case of error, instead of a JSON string you get a string starting with #ERR and the reason of the error.

Top videos by view from TWICE (id=208):
http://www.aoimirai.net/kpop/api.ajax?command=listVideos&listType=topViews&filterGroup=208

Top videos by like from MALE artists:
http://www.aoimirai.net/kpop/api.ajax?command=listVideos&listType=topLikes&filterGenre=male

Top Artists by followers:
http://www.aoimirai.net/kpop/api.ajax?command=listArtists&listType=topFollowers

Test yourself:

Keep in mind these tests will also count towards the 12 request per day limit
Database is under maintenance

Ads by google (click here to hide, consider tipping me to maintain the site)
pessoas usaram esta ferramenta de estatisticas nos últimos 7 dias