Documentação: Artistas

Jessie J Ne-Yo

Além das letras existem várias informações disponíveis sobre o artista. Dados como quantidade de acessos, posição no ranking, gênero musical, músicas mais acessadas do artista, discografia e muito mais.

É importante dizer que a URL que deve ser utilizada é o endereço do artista (obtido pela API de busca).

Exemplo Javascript

Para que seja possível acessar a API via Javascript a partir do seu domínio, permitimos o acesso de outra origem com o Cross-Origin Resource Sharing (já suportado no Chrome e Firefox). Para os outros navegadores, você também pode utilizar a requisição JSONP passando um parâmetro de callback.

O exemplo abaixo é bem simples e utiliza getJSON do jQuery (sem necessidade de especificar o callback).

// Exemplo de requisição
jQuery.getJSON(
	"https://www.vagalume.com.br/u2/index.js",
	function (data) {
		// Nome do artista
		alert(data.artist.desc);
	}
);

Onde /u2/ corresponde a URL do artista no Vagalume.

Resposta da consulta em JSON

URL: https://www.vagalume.com.br/u2/index.js

// Exemplo de retorno da requisição
{
	"artist":{
		"id":"3ade68b2g3b86eda3",
		"desc":"U2",
		"url":"/u2/",
		"pic_small":"/u2/images/profile.jpg",
		"pic_medium":"/u2/images/u2.jpg",
		"rank":{
			"pos":"102",
			"period":201110,
			"views":"284526",
			"uniques":"112363",
			"points":"17.1"
		},
		"genre":
			[
				{
					"name":"Rock Alternativo",
					"url":"/browse/style/rock-alternativo.html"
				},{
					"name":"Rock",
					"url":"/browse/style/rock.html"
				},
				...
			],
		"related":
			[
				{
					"id":"3ade68b5ge177eda3",
					"name":"Pearl Jam",
					"url":"/pearl-jam/"
				},{
					"id":"3ade68b5g1bf7eda3",
					"name":"Queen",
					"url":"/queen/"
				},
				...
			],
		"toplyrics":{
			"item":
				[
					{
						"id":"3ade68b6gc1d8fda3",
						"desc":"With Or Without You (tradu\u00e7\u00e3o)",
						"url":"/u2/with-or-without-you-traducao.html"
					},{
						"id":"3ade68b3gdb86eda3",
						"desc":"One",
						"url":"/u2/one.html"
					},
					...
				]
		},
		"albums":{
			"item":
				[
					{
						"id":"3ade68b6g4f38fda3",
						"desc":"No line on the horizon",
						"url":"/u2/discografia/no-line-on-the-horizon.html",
						"year":"2009",
						"label":"Island/Universal"
					},{
						"id":"3ade68b6ge7e7fda3",
						"desc":"U218 Singles",
						"url":"/u2/discografia/u218-singles.html",
						"year":"2006",
						"label":"Island/Polygram"
					},
					...
				]
		}
	}
}

As propriedades do objeto JSON de resposta são as seguintes:

artistContém informações do artista no Vagalume:
idID do artista no Vagalume descNome do artista urlURL da página do artista no Vagalume pic_smallURL da imagem do artista (tamanho pequeno) pic_mediumURL da imagem do artista (tamanho médio) rankContém informações do ranking do artista no Vagalume
posPosição do artista no ranking periodPeríodo de avaliação (Formato: aaaamm) viewsQuantidade de visualizações uniquesQuantidade de usuários únicos pointsPontuação no ranking
genreContém os gêneros relacionados ao artista
nameNome do gênero urlURL do gênero no Vagalume
relatedContém os artistas relacionados ao artista pesquisado
idID do artista no Vagalume nameNome do artista urlUrl da página do artista no Vagalume
toplyricsContém as músicas mais acessadas do artista
item 
idID da música descO título da música urlA URL da música no Vagalume
albumsContém os álbuns do artista
item 
idID do álbum no Vagalume descNome do álbum urlURL da página do álbum no Vagalume yearAno de lançamento do álbum (se houver) labelNome da gravadora (se houver)