API v3 has been deprecated. Please use API v4 instead

Artists

Artist resources are people profiles: either actors in movies and tv shows, or musicians with music channels. Artists can have more than one role, which can be easily checked by the role attribute in the Artist resource.

Note: Artists with the role ‘musician’ can have a list of Music Videos associated with them.

List Artists

Get a list of artists resources on Viki. 

GET: /api/v3/artists(.json|.xml){.codeblock}

Response

Here’s a sample response, with only one artist resource in the listing for brevity’s sake.

{
  count:293,
  pagination:{
    previous:"",
    next:"http://www.viki.com/api/v3/artists.json?page=2"
  },
  response:[
    {
      id:9542,
      name:"PSY",
      name_language:"en",
      description:"PSY (싸이), born December 31, 1977, whose birth name is Park Jae-Sang (박재상) is a Korean Hip Hop artist under the YG entertainment label.",
      description_language:"en",
      created_at:"August 03, 2012 17:42",
      uri:"http://www.viki.com/api/v3/artists/9542.json",
      web_uri:"http://www.viki.com/channels/9542-psy",
      image:"http://m3.viki.com/aHR0cDovL2MyLnZpa2lhc3NldHMuY29tL3VwbG9hZHMvY2hhbm5lbC90aHVtYm5haWwvOTU0Mi85ZGMyOTBjMTI3Zjc2OWE2NzU1OTdiOTFlY2Q1OGY5MTA4NmRiM2QyLmpwZw==",
      origin_country:"Korea",
      roles:[
        "Musician"
      ],
      music_videos:{
        count:2,
        uri:"http://www.viki.com/api/v3/artists/9542/music_videos.json"
      }
    },
    {
      id:9478,
      name:"Namaste",
      name_language:"en",
      description:"",
      description_language:"",
      created_at:"July 30, 2012 10:03",
      uri:"http://www.viki.com/api/v3/artists/9478.json",
      web_uri:"http://www.viki.com/channels/9478-namaste",
      image:"http://m0.viki.com/aHR0cDovL2MwLnZpa2lhc3NldHMuY29tL3VwbG9hZHMvY2hhbm5lbC90aHVtYm5haWwvOTQ3OC84N2M2N2JhOWZjNDRiMzY1MWM1OTM2N2Q2YzRhNDlhNWFlNGZmYTk5LmpwZw==",
      origin_country:"Korea",
      roles:[
        "Musician"
      ],
      music_videos:{
        count:1,
        uri:"http://www.viki.com/api/v3/artists/9478/music_videos.json"
      }
    },
    {
      id:9410,
      name:"Robert Evan ",
      name_language:"en",
      description:"Robert Evans is an American singer and actor best known for playing the title role in the original Broadway cast of “Jekyll & Hyde.” He is a member of the rock band Trans-Siberian Orchestra but has found success in productions of “Les Misérables” and “Little Shop of Horrors” on Broadway and a number of other popular off-Broadway productions. Watch the music video of “Can You Hear Me?” (with Linda Eder), featured on the soundtrack of the South Korean musical drama “Tears of Heaven” (2011).",
      description_language:"en",
      created_at:"July 26, 2012 05:11",
      uri:"http://www.viki.com/api/v3/artists/9410.json",
      web_uri:"http://www.viki.com/channels/9410-robert-evan",
      image:"http://m1.viki.com/aHR0cDovL2MzLnZpa2lhc3NldHMuY29tL3VwbG9hZHMvY2hhbm5lbC90aHVtYm5haWwvOTQxMC8yNGU0ZGMyMzJiODg1ZjI5MzIyZGYzODFjZTk0NjU4MDY5NmNkMDJhLnBuZw==",
      origin_country:"Korea",
      roles:[
        "Musician"
      ],
      music_videos:{
        count:1,
        uri:"http://www.viki.com/api/v3/artists/9410/music_videos.json"
      }
    },
    {
      id:9258,
      name:"Sagging Snail",
      name_language:"en",
      description:"Sagging Snail is a South Korean pop duo that was formed in 2011 by singer Lee Juk and MC Yoo Jae Suk. They have received positive reception for their songs and appearances on television shows. Watch the popular music video of their popular song “Room Nallari.”",
      description_language:"en",
      created_at:"July 14, 2012 08:35",
      uri:"http://www.viki.com/api/v3/artists/9258.json",
      web_uri:"http://www.viki.com/channels/9258-sagging-snail",
      image:"http://m2.viki.com/aHR0cDovL2MxLnZpa2lhc3NldHMuY29tL3VwbG9hZHMvY2hhbm5lbC90aHVtYm5haWwvOTI1OC9kMTk3ZTU4ZDBmNWUzMzliY2E5MjY0MjljYjI2NzA1OWQxOTkxYjFkLmpwZw==",
      origin_country:"Korea",
      roles:[
        "Musician"
      ],
      music_videos:{
        count:1,
        uri:"http://www.viki.com/api/v3/artists/9258/music_videos.json"
      }
    },
    {
      id:9257,
      name:"December",
      name_language:"en",
      description:"December is a South Korean R&B duo that debuted in 2009. It comprises Yun Hyuk (Lee Yun Hyuk, born February 28, 1986) and DK (Han Dae Kyu, born April 13, 1986). They have been dubbed the next Brown Eyes or SG Wannabe and are known for their power ballads. They gained popularity after one of their songs was featured in the soundtrack for the drama “Iris” (2009). Watch the music video of their popular song “Unfinished.”",
      description_language:"en",
      created_at:"July 14, 2012 08:33",
      uri:"http://www.viki.com/api/v3/artists/9257.json",
      web_uri:"http://www.viki.com/channels/9257-december",
      image:"http://m0.viki.com/aHR0cDovL2MyLnZpa2lhc3NldHMuY29tL3VwbG9hZHMvY2hhbm5lbC90aHVtYm5haWwvOTI1Ny9hNzkwMmZmMGUyNWY2NzUwZjY5NmI3ZjNmOGM3NjI2YmI5NWE4OWYzLmpwZw==",
      origin_country:"Korea",
      roles:[
        "Musician"
      ],
      music_videos:{
        count:1,
        uri:"http://www.viki.com/api/v3/artists/9257/music_videos.json"
      }
    },
    {
      id:9256,
      name:"BOOM ",
      name_language:"en",
      description:"Boom is the stage name of South Korean singer, rapper and actor Lee Min Ho. Born on May 10, 1982, he first debuted in 2006 as a hip hop singer in the band Nu Clear. Boom began to make a name for himself after his comedic appearances on a variety of shows and then gained popularity as an MC on shows such as “Idol Show,” “Star King” and “Champagne” beginning in 2008. Watch the music video of his popular song “Leave It to Play (featuring Gaeko).”",
      description_language:"en",
      created_at:"July 14, 2012 08:31",
      uri:"http://www.viki.com/api/v3/artists/9256.json",
      web_uri:"http://www.viki.com/channels/9256-boom",
      image:"http://m0.viki.com/aHR0cDovL2MyLnZpa2lhc3NldHMuY29tL3VwbG9hZHMvY2hhbm5lbC90aHVtYm5haWwvOTI1Ni8wZGFhZmFhNTQ2YWZjY2U5NzY1Y2Y5ODlkYTA5NWQzYzgyYzVhMWY0LmpwZw==",
      origin_country:"Korea",
      roles:[
        "Musician"
      ],
      music_videos:{
        count:1,
        uri:"http://www.viki.com/api/v3/artists/9256/music_videos.json"
      }
    },
    {
      id:8879,
      name:"Whee Sung",
      name_language:"en",
      description:"Whee Sung is the stage name for Choi Hwee Sung, a South Korean R&B singer-songwriter and record producer. Born on February 5, 1982, he also is known as “The RealSlow” or the “Korean R&B Prince.” Whee Sung has won numerous awards since his debut in 1999 and is a well-respected artist who has collaborated with many popular singers. Watch the music video of his popular song “Should I Catch the Flu?”",
      description_language:"en",
      created_at:"June 13, 2012 06:34",
      uri:"http://www.viki.com/api/v3/artists/8879.json",
      web_uri:"http://www.viki.com/channels/8879-whee-sung",
      image:"http://m1.viki.com/aHR0cDovL2MzLnZpa2lhc3NldHMuY29tL3VwbG9hZHMvY2hhbm5lbC90aHVtYm5haWwvODg3OS8yMGIyMDk1MTUwOTA3Yzc5MGE1ZThkNmEzYjg3YWI4M2UyOGVmYjllLmpwZw==",
      origin_country:"Korea",
      roles:[
        "Musician"
      ],
      music_videos:{
        count:1,
        uri:"http://www.viki.com/api/v3/artists/8879/music_videos.json"
      }
    },
    {
      id:8805,
      name:"Kim Jo Han",
      name_language:"en",
      description:"Kim Jo Han, also known as George Han Kim, is a Korean American R&B singer. Born on March 27, 1973, in the United States, Jo Han has been active in the Korean music industry for decades. He rose to fame in the 1990s as the lead singer for the R&B group Solid. When the group disbanded in 1996, he has produced and written songs for other artists and has released some solo albums. Watch the music video for his popular song “Let’s Start Our Love Again.”",
      description_language:"en",
      created_at:"June 06, 2012 07:47",
      uri:"http://www.viki.com/api/v3/artists/8805.json",
      web_uri:"http://www.viki.com/channels/8805-kim-jo-han",
      image:"http://m1.viki.com/aHR0cDovL2MxLnZpa2lhc3NldHMuY29tL3VwbG9hZHMvY2hhbm5lbC90aHVtYm5haWwvODgwNS9mMWI5YWRmOGQ0ODkxZDdkNjZjMWYwYzkwMmU4YTYyZDgxNmMzOWExLmpwZw==",
      origin_country:"Korea",
      roles:[
        "Musician"
      ],
      music_videos:{
        count:1,
        uri:"http://www.viki.com/api/v3/artists/8805/music_videos.json"
      }
    },
    {
      id:8804,
      name:"2BiC",
      name_language:"en",
      description:"2BiC is a South Korean pop duo that debuted in 2012. Named and produced by Cho Young Soo, a famous Korean composer, 2BiC stands for “2 Bi Continue,” which is the two members’ pledge to continue making music together. Members Jihwan and Junhyung have been compared to power ballad group SG Wannabe and have demonstrated strong vocal power. Watch the music video for their popular song “Just Like Tonight” (with Davichi).",
      description_language:"en",
      created_at:"June 06, 2012 07:46",
      uri:"http://www.viki.com/api/v3/artists/8804.json",
      web_uri:"http://www.viki.com/channels/8804-2bic",
      image:"http://m0.viki.com/aHR0cDovL2MxLnZpa2lhc3NldHMuY29tL3VwbG9hZHMvY2hhbm5lbC90aHVtYm5haWwvODgwNC83YjkzOWVmZGIxOThkYzNiNDEwYzIyOTNiMzYyODhhOGMxNzVkMzdkLmpwZw==",
      origin_country:"Korea",
      roles:[
        "Musician"
      ],
      music_videos:{
        count:3,
        uri:"http://www.viki.com/api/v3/artists/8804/music_videos.json"
      }
    },
    {
      id:8803,
      name:"Cultwo",
      name_language:"en",
      description:"Cultwo is a South Korean comedic singing duo known for their funny renditions of popular songs. Watch the music video of their hit song “I Didn’t Know HUL TT.”",
      description_language:"en",
      created_at:"June 06, 2012 07:44",
      uri:"http://www.viki.com/api/v3/artists/8803.json",
      web_uri:"http://www.viki.com/channels/8803-cultwo",
      image:"http://m2.viki.com/aHR0cDovL2MzLnZpa2lhc3NldHMuY29tL3VwbG9hZHMvY2hhbm5lbC90aHVtYm5haWwvODgwMy9iMmRhMzZjNTY5NTFkNjMyZDQ3MWYyMjgzNTBlYjhmYzA2ZTdhZmQzLmpwZw==",
      origin_country:"Korea",
      roles:[
        "Musician"
      ],
      music_videos:{
        count:2,
        uri:"http://www.viki.com/api/v3/artists/8803/music_videos.json"
      }
    },
    {
      id:8802,
      name:"J-Cera",
      name_language:"en",
      description:"J-Cera is a South Korean pop singer who debuted in 2010 who is known for her ability to hit seven high notes with her strong vocals. Born January 18, 1988, J-Cera is known as the “faceless singer” because her appearance has not been made public. Watch the music video of her hit song “You and I.”",
      description_language:"en",
      created_at:"June 06, 2012 07:39",
      uri:"http://www.viki.com/api/v3/artists/8802.json",
      web_uri:"http://www.viki.com/channels/8802-j-cera",
      image:"http://m2.viki.com/aHR0cDovL2MyLnZpa2lhc3NldHMuY29tL3VwbG9hZHMvY2hhbm5lbC90aHVtYm5haWwvODgwMi9mMDk5ZWY1ZThmNTliMjMyNWUxYWZkYjU0ZTUxMmQwYzA4MWI3ZjhhLmpwZw==",
      origin_country:"Korea",
      roles:[
        "Musician"
      ],
      music_videos:{
        count:1,
        uri:"http://www.viki.com/api/v3/artists/8802/music_videos.json"
      }
    },
    {
      id:8801,
      name:"Jang Hee Young",
      name_language:"en",
      description:"Jang Hee Young is a South Korean pop singer who is best known as the former lead singer for the R&B girl group Gavy NJ. Born March 25, 1985, Hee Young left the girl group after six years in 2011 to pursue a solo career. Watch the music video of her hit song “Love Is Pain” (featuring Gilme).",
      description_language:"en",
      created_at:"June 06, 2012 07:36",
      uri:"http://www.viki.com/api/v3/artists/8801.json",
      web_uri:"http://www.viki.com/channels/8801-jang-hee-young",
      image:"http://m1.viki.com/aHR0cDovL2MyLnZpa2lhc3NldHMuY29tL3VwbG9hZHMvY2hhbm5lbC90aHVtYm5haWwvODgwMS85ZWFlODNmNWJiNmU4MjVkYjU5ZTk3M2M4MTM3YWU4NTcwZjhlMzZhLmpwZw==",
      origin_country:"Korea",
      roles:[
        "Musician"
      ],
      music_videos:{
        count:1,
        uri:"http://www.viki.com/api/v3/artists/8801/music_videos.json"
      }
    },
    {
      id:8800,
      name:"Yoo Jun Sang",
      name_language:"en",
      description:"Yoo Jun Sang is a popular South Korean actor and singer. In addition to television and film, Jun Sang has built a successful career in musical theater. He also plays the guitar, saxophone, violin and piano. Watch the music video of his song “Ce Song” (featuring Kim Sang Ho and Kwak Dong Hyun).",
      description_language:"en",
      created_at:"June 06, 2012 07:34",
      uri:"http://www.viki.com/api/v3/artists/8800.json",
      web_uri:"http://www.viki.com/channels/8800-yoo-jun-sang",
      image:"http://m1.viki.com/L2Fzc2V0cy9jaGFubmVsX2RlZmF1bHRfbWVkaXVtLTVlMTkwNGZjMThiYjEyY2UzZDlmYjBhZGRkZGM2NDM5LnBuZw==",
      origin_country:"Korea",
      roles:[
        "Musician"
      ],
      music_videos:{
        count:1,
        uri:"http://www.viki.com/api/v3/artists/8800/music_videos.json"
      }
    },
    {
      id:8799,
      name:"Bohemian",
      name_language:"en",
      description:"Bohemian is a three-member South Korean band that debuted in 2010. The group launched its career after being featured in the soundtrack for the popular Korean drama series “Life is Beautiful” (2010). Watch the music video of the group’s popular song “Don’t Be Hurt.”",
      description_language:"en",
      created_at:"June 06, 2012 07:33",
      uri:"http://www.viki.com/api/v3/artists/8799.json",
      web_uri:"http://www.viki.com/channels/8799-bohemian",
      image:"http://m3.viki.com/aHR0cDovL2MzLnZpa2lhc3NldHMuY29tL3VwbG9hZHMvY2hhbm5lbC90aHVtYm5haWwvODc5OS83NjkyOWM0ZjczYTNlZDg5MDZjMjcwZWI5Mjg5M2E4YzE2OGY4MTZkLmpwZw==",
      origin_country:"Korea",
      roles:[
        "Musician"
      ],
      music_videos:{
        count:2,
        uri:"http://www.viki.com/api/v3/artists/8799/music_videos.json"
      }
    },
    {
      id:8798,
      name:"Ha Hyun Gon Factory",
      name_language:"en",
      description:"Ha Hyun Gon Factory is the stage name of Ha Hyun Gon, a South Korean pop singer who is best known as the drummer for the popular boy band Click-B. He left the group in 2002 to pursue a solo career but returned in 2011. Watch the music videos of his hit solo songs.",
      description_language:"en",
      created_at:"June 06, 2012 07:30",
      uri:"http://www.viki.com/api/v3/artists/8798.json",
      web_uri:"http://www.viki.com/channels/8798-ha-hyun-gon-factory",
      image:"http://m1.viki.com/aHR0cDovL2MzLnZpa2lhc3NldHMuY29tL3VwbG9hZHMvY2hhbm5lbC90aHVtYm5haWwvODc5OC9hNjUyNjYxM2QxYjc0Yzg1ODRmY2NlYTlmMWVmODJhYjM0ZDUwN2ExLmpwZw==",
      origin_country:"Korea",
      roles:[
        "Musician"
      ],
      music_videos:{
        count:2,
        uri:"http://www.viki.com/api/v3/artists/8798/music_videos.json"
      }
    },
    {
      id:8797,
      name:"DIA",
      name_language:"en",
      description:"DIA is the stage name of Kim Ji Eun, a South Korean pop singer who debuted in 2009. Born on June 12, 1992, she won a number of music festival awards in 2008 prior to her official debut. DIA is considered an underrated musician who has been accused of imitating the singer Bom from 2NE1, although she debuted prior to Bom. Watch the music video of her song “Speed Dial No. 1.”",
      description_language:"en",
      created_at:"June 06, 2012 07:26",
      uri:"http://www.viki.com/api/v3/artists/8797.json",
      web_uri:"http://www.viki.com/channels/8797",
      image:"http://m0.viki.com/aHR0cDovL2MzLnZpa2lhc3NldHMuY29tL3VwbG9hZHMvY2hhbm5lbC90aHVtYm5haWwvODc5Ny8xMGMyOGFiNGI3YWZkOTUyNWY0MjIxMDllMzg5NWRkNzk3YTM5NTJlLmpwZw==",
      origin_country:"Korea",
      roles:[
        "Musician"
      ],
      music_videos:{
        count:1,
        uri:"http://www.viki.com/api/v3/artists/8797/music_videos.json"
      }
    },
    {
      id:8796,
      name:"Sweet Sorrow",
      name_language:"en",
      description:"Sweet Sorrow is a South Korean boy band that took its name from Shakespeare’s famous play “Romeo and Juliet.” The four members –In Ho Jin, Song Woo Jin, Kim Young Woo and Sung Jin Hwan – met through an a cappella group in the Glee Club at Yonsei University. The group launched their music career after winning a singing competition in 2004 and gained fame after winning the second season of the talent show “Showvival” in 2007. Watch the music video of their song “You Are My Heaven.”",
      description_language:"en",
      created_at:"June 06, 2012 07:23",
      uri:"http://www.viki.com/api/v3/artists/8796.json",
      web_uri:"http://www.viki.com/channels/8796-sweet-sorrow",
      image:"http://m1.viki.com/L2Fzc2V0cy9jaGFubmVsX2RlZmF1bHRfbWVkaXVtLTVlMTkwNGZjMThiYjEyY2UzZDlmYjBhZGRkZGM2NDM5LnBuZw==",
      origin_country:"Korea",
      roles:[
        "Musician"
      ],
      music_videos:{
        count:1,
        uri:"http://www.viki.com/api/v3/artists/8796/music_videos.json"
      }
    },
    {
      id:8795,
      name:"Devil Mouth",
      name_language:"en",
      description:"Devil Mouth is a South Korean male pop group popular for its high-energy dance songs. Watch the music video of its song “Follow Me.” ",
      description_language:"en",
      created_at:"June 06, 2012 07:20",
      uri:"http://www.viki.com/api/v3/artists/8795.json",
      web_uri:"http://www.viki.com/channels/8795-devil-mouth",
      image:"http://m2.viki.com/aHR0cDovL2MwLnZpa2lhc3NldHMuY29tL3VwbG9hZHMvY2hhbm5lbC90aHVtYm5haWwvODc5NS81YWE2NjQ4ZDViMDJmOWI2NmU3ZDM2OGRlNGQyODViZGQ1ZTYzZTMwLmpwZw==",
      origin_country:"Korea",
      roles:[
        "Musician"
      ],
      music_videos:{
        count:1,
        uri:"http://www.viki.com/api/v3/artists/8795/music_videos.json"
      }
    },
    {
      id:8794,
      name:"Big MaMa Soul",
      name_language:"en",
      description:"BigMAMA Soul is a sub-unit of the four-member South Korean girl group BigMAMA, which garnered international attention after making the pledge to focus on their music rather than their appearances. The sub-unit, which released its debut solo album in 2011, comprises members Shin Yeon Ah and Park Min Hye. Watch the music videos of their songs.",
      description_language:"en",
      created_at:"June 06, 2012 07:16",
      uri:"http://www.viki.com/api/v3/artists/8794.json",
      web_uri:"http://www.viki.com/channels/8794-big-mama-soul",
      image:"http://m2.viki.com/aHR0cDovL2MyLnZpa2lhc3NldHMuY29tL3VwbG9hZHMvY2hhbm5lbC90aHVtYm5haWwvODc5NC84M2MxYzc4NDNiOTIyZjg4ZDE0YmUzNGFhZDFhODk0ZmJjNDk3MzcwLmpwZw==",
      origin_country:"Korea",
      roles:[
        "Musician"
      ],
      music_videos:{
        count:1,
        uri:"http://www.viki.com/api/v3/artists/8794/music_videos.json"
      }
    },
    {
      id:8771,
      name:"Nu'est",
      name_language:"en",
      description:"NU'EST (New Established Style and Tempo) is a South Korean boy group formed by Pledis Entertainment in 2012. They are also Pledis Entertainment's first male band, consisting of JR, Aron, Minhyun, Baekho and Ren. Their musical style is described as 'urban electro'.",
      description_language:"en",
      created_at:"June 03, 2012 05:28",
      uri:"http://www.viki.com/api/v3/artists/8771.json",
      web_uri:"http://www.viki.com/channels/8771-nu-est",
      image:"http://m1.viki.com/aHR0cDovL2MzLnZpa2lhc3NldHMuY29tL3VwbG9hZHMvY2hhbm5lbC90aHVtYm5haWwvODc3MS9mODg1NjBiYmI0YzU5NTU2Nzk2OTIzNTNlNjc3ZWQxNGRhM2UwZjQ2LmpwZw==",
      origin_country:"Korea",
      roles:[
        "Musician"
      ],
      music_videos:{
        count:4,
        uri:"http://www.viki.com/api/v3/artists/8771/music_videos.json"
      }
    },
    {
      id:8615,
      name:"Michelle Branch",
      name_language:"en",
      description:"Michelle Branch is an American singer-songwriter, guitarist and actress known for her folksy country pop songs. Born July 2, 1983, in Phoenix, Arizona, Michelle was part of the country duo The Wreckers with country singer Jessica Harp from 2005 to 2007 but disbanded to continue working as a solo artist. She won a Grammy Award in 2003. Watch the music videos of her hit songs “Goodbye to You,” “Are You Happy Now?”  “Everywhere” and “All You Wanted”.",
      description_language:"en",
      created_at:"May 21, 2012 19:04",
      uri:"http://www.viki.com/api/v3/artists/8615.json",
      web_uri:"http://www.viki.com/channels/8615-michelle-branch",
      image:"http://m1.viki.com/aHR0cDovL2MyLnZpa2lhc3NldHMuY29tL3VwbG9hZHMvY2hhbm5lbC90aHVtYm5haWwvODYxNS84ODIxMWJhYmNhYzc3YjNhMGM1MDBlMWQ3ZjU3YjNkOTg1OTUxNWRkLmpwZw==",
      origin_country:"United States",
      roles:[
        "Musician"
      ],
      music_videos:{
        count:4,
        uri:"http://www.viki.com/api/v3/artists/8615/music_videos.json"
      }
    },
    {
      id:8614,
      name:"Michael Bublé",
      name_language:"en",
      description:"Michael Bublé is an Italian-Canadian singer-songwriter known for his smooth jazzy vocals. Born on September 9, 1975, in Burnaby, British Columbia, Michael’s velvety voice has covered many standard jazz tunes on his successful albums, as well as original songs he helped to write. He has won many Grammy and Juno awards and featured on movie soundtracks since he debuted in 1996. Watch the music videos of his popular songs “When a Man Loves a Woman,” “Me and Mrs. Jones,” and “Crazy Love”.",
      description_language:"en",
      created_at:"May 21, 2012 19:03",
      uri:"http://www.viki.com/api/v3/artists/8614.json",
      web_uri:"http://www.viki.com/channels/8614-michael-buble",
      image:"http://m2.viki.com/aHR0cDovL2MzLnZpa2lhc3NldHMuY29tL3VwbG9hZHMvY2hhbm5lbC90aHVtYm5haWwvODYxNC85YTYxNDU1ZGY0NWM2YmEyNTUxN2ViZTRlMzVlMWQwMjlhNWQxMzdjLmpwZw==",
      origin_country:"Canada",
      roles:[
        "Musician"
      ],
      music_videos:{
        count:1,
        uri:"http://www.viki.com/api/v3/artists/8614/music_videos.json"
      }
    },
    {
      id:8613,
      name:"Madonna",
      name_language:"en",
      description:"Madonna, an American singer-songwriter, actress and entrepreneur, is a true pop music icon who is known around the world. Born on August 16, 1958, as Madonna Louise Ciccone, she is recognized as the world’s top-selling female recording artist of all time by the Guinness World Records. In 2008, she was inducted into the Rock and Roll Hall of Fame. In 2012, she was crowned the “Greatest Woman in Music” by VH1. Watch the music videos of her hit songs “Vogue” and “Everybody”.",
      description_language:"en",
      created_at:"May 21, 2012 19:01",
      uri:"http://www.viki.com/api/v3/artists/8613.json",
      web_uri:"http://www.viki.com/channels/8613-madonna",
      image:"http://m0.viki.com/aHR0cDovL2MxLnZpa2lhc3NldHMuY29tL3VwbG9hZHMvY2hhbm5lbC90aHVtYm5haWwvODYxMy85NDVhMTQ0MjVlMmMyY2JhOTcyNzQ4ZWJjZjhlMjkzNmQwMGQ0OTA3LmpwZw==",
      origin_country:"United States",
      roles:[
        "Musician"
      ],
      music_videos:{
        count:2,
        uri:"http://www.viki.com/api/v3/artists/8613/music_videos.json"
      }
    },
    {
      id:8612,
      name:"Simple Plan",
      name_language:"en",
      description:"Simple Plan is a popular Canadian punk pop band that has won numerous Juno and other awards since its debut in 1999. The members of the band are Pierre Bouvier (lead vocals), Jeff Stinco (lead guitar), Sébastien Lefebvre (rhythm guitar, backing vocals), David Desrosiers (bass guitar, backing vocals) and Chuck Comeau (drums and percussion). Watch the music videos of their hit songs “Shut Up!” “Crazy,” and “Welcome to My Life”.",
      description_language:"en",
      created_at:"May 21, 2012 19:00",
      uri:"http://www.viki.com/api/v3/artists/8612.json",
      web_uri:"http://www.viki.com/channels/8612-simple-plan",
      image:"http://m3.viki.com/aHR0cDovL2MxLnZpa2lhc3NldHMuY29tL3VwbG9hZHMvY2hhbm5lbC90aHVtYm5haWwvODYxMi8zZjBjNDI2ZjdhMTc2NjMwZWNjMTY5YmZkODVmYTlhNGZhZjBiOWUxLmpwZw==",
      origin_country:"Canada",
      roles:[
        "Musician"
      ],
      music_videos:{
        count:3,
        uri:"http://www.viki.com/api/v3/artists/8612/music_videos.json"
      }
    },
    {
      id:8611,
      name:"Green Day",
      name_language:"en",
      description:"Green Day, an American punk rock band that formed in 1987, is credited for helping to bring mainstream interest to punk rock music. The band has won numerous Grammy Awards and sold millions of records. The band members are Billie Joe Armstrong (lead vocalist and guitarist), Mike Dirnt (bassist and backing vocalist) and Tre Cool (drummer). Watch the music videos of their hit songs, including “Boulevard of Broken Dreams,” “American Idiot,” “Basket Case,” “Holiday” and “Know Your Enemy”.",
      description_language:"en",
      created_at:"May 21, 2012 18:58",
      uri:"http://www.viki.com/api/v3/artists/8611.json",
      web_uri:"http://www.viki.com/channels/8611-green-day",
      image:"http://m3.viki.com/aHR0cDovL2MwLnZpa2lhc3NldHMuY29tL3VwbG9hZHMvY2hhbm5lbC90aHVtYm5haWwvODYxMS9mOTI0ZjRiOGExOGQ1ZmNiODg0ODQ3ODE4MzEzNGYwNzlhNTgzMThmLmpwZw==",
      origin_country:"United States",
      roles:[
        "Musician"
      ],
      music_videos:{
        count:13,
        uri:"http://www.viki.com/api/v3/artists/8611/music_videos.json"
      }
    }
  ]
}

Parameter Filters

You may add the following parameter options to filter results accordingly. 

  • origin_country{.params}
  • platform{.params}
  • watchable_in{.params}

origin_country {.params}

Filters artist according to their country of origin. This parameter takes in a two-lettered country code. See here for a full list of usable country codes. For example,

GET /api/v3/artists.json?access_token=ACCESS_TOKEN&origin_country=kr{.codeblock}

will return all artists from Korea.

platform{.params}

Filters artists according to licensed platform. This parameter is only available if watchable_in is also passed to the API endpoint. Some content providers on Viki have licensed their content only for certain platforms. You may filter using the platform parameter to ensure that the artists listings you receive are associated with content playable on your particular app platform.

Possible platform options: mobile,  web,  tv

watchable_in{.params}

Filters according to region licensing availability. Some content providers on Viki have licensed their content only for specific regions. These shows associated with the artist resource are restricted at a video level, which means that they won’t be playable should a user choose to view the video link. To prevent your users from seeing a listing of media they cannot watch, use this parameter to filter out according to country. 

GET /api/v3/artists.json?access_token=ACCESS_TOKEN&watchable_in=us{.codeblock}

will return all artists that are watchable in the US. See here for a full list of usable country codes.

Parameter Options

  • language{.params}
  • page{.params}
  • per_page{.params}
  • order{.params}
  • time_period{.params}

language{.params}

the language parameter may be passed to display artist names and descriptions in your language of choice. For example,

GET /api/v3/artists.json?access_token=ACCESS_TOKEN&language=ko{.codeblock}

will return a list of artist resources with names and descriptions in Korean. For items with no Korean translations available, titles and descriptions will default to English. See here for a full list of usable language codes.

page{.params}

the page option is used to get a specific page of results. By default API responses are paginated, with 25 items per page. So:

GET /api/v3/artists.json?access_token=ACCESS_TOKEN&page=2{.codeblock}

will return the second page of the artists results.

per_page{.params}

the per_page option is used to specify the number of items per page.

order{.params}

The order option is used to specify the sorting criteria of results. Possible values are:

  • title - sorts resources by title (alphabetical)
  • created_at - sorts resources according to creation date (latest)
  • views - sorts resources according to number of views (most popular)

Do note that the views parameter may also be supplemented by specifying a time_period parameter, below:

time_period{.params}

The time_period option is used in addition to the views parameter to specify the time period for popularity. Possible values are:

  • all_time (default)
  • 7days

So for example:

GET /api/v3/artists.json?access_token=ACCESS_TOKEN&order=views&time_period=7days{.codeblock}

will return a list of artists sorted by popularity from the past 7 days.

Show Artist

Get a single artist resource.

GET: /api/v3/artists/:id(.json|.xml){.codeblock}

A sample query:

GET: /api/v3/artists/8615.json?access_token=ACCESS_TOKEN{.codeblock}

Response:

{
  id:8615,
  name:"Michelle Branch",
  name_language:"en",
  description:"Michelle Branch is an American singer-songwriter, guitarist and actress known for her folksy country pop songs. Born July 2, 1983, in Phoenix, Arizona, Michelle was part of the country duo The Wreckers with country singer Jessica Harp from 2005 to 2007 but disbanded to continue working as a solo artist. She won a Grammy Award in 2003. Watch the music videos of her hit songs “Goodbye to You,” “Are You Happy Now?”  “Everywhere” and “All You Wanted”.",
  description_language:"en",
  created_at:"May 21, 2012 19:04",
  uri:"http://www.viki.com/api/v3/artists/8615.json",
  web_uri:"http://www.viki.com/channels/8615-michelle-branch",
  image:"http://m1.viki.com/aHR0cDovL2MyLnZpa2lhc3NldHMuY29tL3VwbG9hZHMvY2hhbm5lbC90aHVtYm5haWwvODYxNS84ODIxMWJhYmNhYzc3YjNhMGM1MDBlMWQ3ZjU3YjNkOTg1OTUxNWRkLmpwZw==",
  origin_country:"United States",
  roles:[
    "Musician"
  ],
  music_videos:{
    count:4,
    uri:"http://www.viki.com/api/v3/artists/8615/music_videos.json"
  }
}