Richie Sambora (Bon Jovi)

Documentação: Hot Spot

  1. O que é "Hot Spot"?
  2. Resposta da consulta em JSON

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.

O que é "Hot Spot"?

O Hot Spot é o nome da seção do Vagalume que é atualizada diariamente na home com novidades de clipes, músicas e conteúdo relevante para os usuários site. Milhões de usuários entram no Vagalume diariamente para saber o que há de novo no mundo da música.

Além do Top 100, o Hot Spot é o lugar mais "quente" onde aparecem sucessos que provavelmente só estarão listados no ranking (veja também a API de Ranking) depois de algumas semanas ou meses.

A atualização do Hot Spot é 100% manual, com seleções que estão de acordo (assim como as notícias) com a linha editorial.

Em breve disponibilizaremos exemplos em Javascript nesta página.

Resposta da consulta em JSON

URL: api.vagalume.com.br/hotspots.php?apikey={key}

// Exemplo de retorno da requisição

{
	"hotspots":
		[
			{
				"id": "3ade68b5g97d7eda3",
				"title": "John Newman",
				"date": "20-07-2014 11:00:00",
				"date_fmt": "20/Jul/2014",
				"link": "https://www.vagalume.com.br/john-newman/all-i-need-is-you.html#play:CQA2yc2a5Ik:3ade68b7g79701ea3:BIG",
				"descr": "Assista ao clipe "All I Need Is You" com legendas!",
				"pic_src": "https://s2.vagalume.com/john-newman/images/104448.jpg",
				"pic_width": "570",
				"pic_height": "315",
				"type": "music",
				"musicID": "3ade68b7g79701ea3"
			},{
				"id": "3ade68b5g98d7eda3",
				"title": "Entrevista: James Blunt",
				"date": "19-07-2014 18:00:00",
				"date_fmt": "19/Jul/2014",
				"link": "https://www.vagalume.com.br/news/2014/07/18/james-blunt-fala-ao-vagalume-minha-turne-so-sera-mundial-se-eu-visitar-o-brasil.html",
				"descr": "Cantor conversa com o Vagalume, conta que vem ao Brasil e elogia fãs brasileiros: "São incríveis!". Leia na íntegra!",
				"pic_src": "https://s2.vagalume.com/james-blunt/images/99623.jpg",
				"pic_width": "570",
				"pic_height": "315",
				"type": "news"
			},
			...
		]
}

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

hotspotsContém informações dos hotspots do Vagalume:
id ID do hotspot title Título do hotspot date Data de inserção do hotspot no Vagalume (Formato: dd-mm-aaaa hh:mm:ss) date_fmt Data de inserção do hotspot no Vagalume (Formato: dd-MMM-aaaa) link URL do hotspot no Vagalume descr Descrição do hotspot pic_src URL da imagem do hotspot pic_width Largura da imagem do hotspot (em pixels) pic_height Altura da imagem do hotspot (em pixels) type Tipo de página que o usuário será redirecionado. Pode ser uma de letra de música (music), uma playlist do Meu Vagalume (playlist), uma notícia (news), ou outra página qualquer (other). Nos casos de "music" ou "playlist", será informado também um ID, conforme lista abaixo:
musicIDSe o hotspot é referente a uma letra de música, este campo informa o ID da letra playlistIDSe o hotspot é referente a uma playlist do Meu Vagalume, este campo informa o ID da playlist