Documentação: Vagalume Rádios

Ne-Yo Snow Patrol
  1. Parâmetros de consulta
  2. Resposta da consulta em JSON
    1. Resposta para artistas
    2. Resposta para músicas
    3. Resposta para artistas e músicas

Importante

Para usar Vagalume API, é necessário que seu aplicativo tenha credenciais de autorização. Cadastre-se no Vagalume e crie sua chave de API. Esta credencial será requerida a partir do dia 23/11/2015.

Parâmetros de consulta

A consulta deve ser realizada via GET para obter informações de TOP músicas e/ou TOP artistas da sua rádio. Como nos exemplos a seguir:
https://api.vagalume.com.br/radio.php?type=art&radio=coca-cola-fm&apikey={key}
https://api.vagalume.com.br/radio.php?type=mus&radio=metropolitana&apikey={key}
https://api.vagalume.com.br/radio.php?type=artmus&radio=jovem-pan-fm-sp&apikey={key}

type Ranking se deseja obter. Valores possíveis: art (artistas), mus (músicas), artmus (artistas e músicas) radio Nome da rádio utilizado na URL da sua página no Vagalume. Exemplo: https://www.vagalume.com.br/radio/coca-cola-fm/

Resposta da consulta em JSON

Resposta para artistas

URL de exemplo: https://api.vagalume.com.br/radio.php?type=art&radio=coca-cola-fm&apikey={key}

{
  "status": "success",
  "art": [
    {
      "id": "3ade68b7g98d71ea3",
      "pos": "1",
      "name": "Bruno Mars",
      "url": "https://www.vagalume.com.br/bruno-mars/",
      "pic_small": "https://www.vagalume.com.br/bruno-mars/images/profile.jpg",
      "pic_medium": "https://www.vagalume.com.br/bruno-mars/images/bruno-mars.jpg"      
    }
  ]
}

Descrição dos valores retornados:

statusContém o status de retorno dos dados pedidos ("success" se a resposta estiver correta ou "error" se estiver incorreta). artContém o tipo de retorno dos dados pedidos. No caso, o ranking de artistas.
id Id do artista no Vagalume pos Posição do artista no ranking name Nome do artista url URL do artista no Vagalume pic_small Imagem do artista em miniatura pic_medium Imagem do artista em tamanho médio

Resposta para músicas

URL de exemplo: http://api.vagalume.com.br/radio.php?type=mus&radio=metropolitana&apikey={key}

{
  "status": "success",
  "mus": [
    {
      "id": "3ade68b8gadffdfa3",
      "pos": "1",
      "name": "High Life",
      "url": "https://www.vagalume.com.br/b-o-b/high-life.html",
      "pic_small": "https://www.vagalume.com.br/bruno-mars/images/profile.jpg",
      "pic_medium": "https://www.vagalume.com.br/bruno-mars/images/bruno-mars.jpg",
      "art": {
        "id": "3ade68b7gaeb31ea3",
        "name": "B.o.B."
        "url": "https://www.vagalume.com.br/b-o-b/",
        "pic_small": "https://www.vagalume.com.br/b-o-b/images/profile.jpg",
        "pic_medium": "https://www.vagalume.com.br/b-o-b/images/b-o-b.jpg"
      }
    }
  ]
}

Descrição dos valores retornados:

statusContém o status de retorno dos dados pedidos ("success" se a resposta estiver correta ou "error" se estiver incorreta). musContém o tipo de retorno dos dados pedidos. No caso, o ranking de músicas.
id Id da música no Vagalume pos Posição da música no ranking name Nome da música url URL da página da música no Vagalume art Artista que interpreta a música.
id Id do artista no Vagalume name Nome do artista url URL do artista no Vagalume pic_small Imagem do artista em miniatura pic_medium Imagem do artista em tamanho médio

Resposta para artistas e músicas

URL de exemplo: http://api.vagalume.com.br/radio.php?type=artmus&radio=jovem-pan-fm-sp&apikey={key}

{
  "status": "success",
  "art": [
    {
      "id": "3ade68b7gaeb31ea3",
      "pos": "1",
      "name": "B.o.B.",
      "url": "https://www.vagalume.com.br/b-o-b/",
      "pic_small": "https://www.vagalume.com.br/b-o-b/images/profile.jpgg",
      "pic_medium": "https://www.vagalume.com.br/b-o-b/images/b-o-b.jpg"      
    }
  ],
  "mus": [
    {
      "id": "3ade68b8gadffdfa3",
      "pos": "1",
      "name": "High Life",
      "url": "https://www.vagalume.com.br/b-o-b/high-life.html",
      "pic_small": "https://www.vagalume.com.br/bruno-mars/images/profile.jpg",
      "pic_medium": "https://www.vagalume.com.br/bruno-mars/images/bruno-mars.jpg",
      "art": {
        "id": "3ade68b7gaeb31ea3",
        "name": "B.o.B."
        "url": "https://www.vagalume.com.br/b-o-b/",
        "pic_small": "https://www.vagalume.com.br/b-o-b/images/profile.jpg",
        "pic_medium": "https://www.vagalume.com.br/b-o-b/images/b-o-b.jpg"
      }
    }
  ]
}

Descrição dos valores retornados:

statusContém o status de retorno dos dados pedidos ("success" se a resposta estiver correta ou "error" se estiver incorreta). artContém ranking de artistas.
id Id do artista no Vagalume pos Posição do artista no ranking name Nome do artista url URL do artista no Vagalume pic_small Imagem do artista em miniatura pic_medium Imagem do artista em tamanho médio
musContém o ranking de músicas.
id Id da música no Vagalume pos Posição da música no ranking name Nome da música url URL da página da música no Vagalume art Artista que interpreta a música.
id Id do artista no Vagalume name Nome do artista url URL do artista no Vagalume pic_small Imagem do artista em miniatura pic_medium Imagem do artista em tamanho médio