{"id":17140649,"url":"https://github.com/gpedro/node-vagalume","last_synced_at":"2025-04-13T10:11:31.583Z","repository":{"id":31537780,"uuid":"35102354","full_name":"gpedro/node-vagalume","owner":"gpedro","description":"Módulo Node do Vagalume API. Crie suas aplicações e integre com o Vagalume! Ofereça conteúdo de qualidade para seus usuários!","archived":false,"fork":false,"pushed_at":"2017-06-17T02:55:33.000Z","size":24,"stargazers_count":25,"open_issues_count":4,"forks_count":4,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-27T01:35:43.319Z","etag":null,"topics":["javascript","music","node","vagalume"],"latest_commit_sha":null,"homepage":"http://api.vagalume.com.br/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gpedro.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-05-05T13:44:32.000Z","updated_at":"2021-12-22T18:38:17.000Z","dependencies_parsed_at":"2022-09-04T16:00:45.143Z","dependency_job_id":null,"html_url":"https://github.com/gpedro/node-vagalume","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gpedro%2Fnode-vagalume","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gpedro%2Fnode-vagalume/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gpedro%2Fnode-vagalume/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gpedro%2Fnode-vagalume/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gpedro","download_url":"https://codeload.github.com/gpedro/node-vagalume/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248695481,"owners_count":21146956,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["javascript","music","node","vagalume"],"created_at":"2024-10-14T20:15:22.015Z","updated_at":"2025-04-13T10:11:31.562Z","avatar_url":"https://github.com/gpedro.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# node-vagalume\n[![NPM version][npm-image]][npm-url] [![Build Status][travis-image]][travis-url] [![Dependency Status][daviddm-image]][daviddm-url] [![Code Climate][climate-image]][climate-url] [![Test Coverage][coverage-image]][coverage-url]\n\nNo Vagalume temos a **performance** como um dos itens mais importantes no desenvolvimento do sistema. Devido a grande quantidade de acessos no site, temos como prioridade o carregamento rápido e escalabilidade da aplicação. Utilizar as funções encontradas na API não devem deixar o seu site mais lento ou gerar problemas de estabilidade em nosso sistema. Nesta documentação devemos abordar as melhores práticas de como fazer requisições de forma assíncrona.\n\n**IMPORTANTE**: ~~O uso da API é totalmente gratuito, mas é muito importante que o [logo](http://api.vagalume.com.br/terms/) e link para a página correspondente no Vagalume estejam presentes. Leia os [termos de uso](http://api.vagalume.com.br/terms/), e verifique se o seu site ou aplicação estão de acordo.~~\n\n**IMPORTANTE**: Para usar Vagalume API, é necessário que seu aplicativo tenha [credenciais de autorização](https://auth.vagalume.com.br/). Cadastre-se no Vagalume e crie sua chave de API. Esta credencial será requerida a partir do dia **23/11/2015**.\n\n## Instalação\n\n```sh\n$ npm install --save vagalume\n```\n\n## Como usar\n\u003e **ATENÇÃO**: Todos os métodos retornam um Promise.\n\n```js\nvar Vagalume = require('vagalume');\nvar api = new Vagalume();\n\napi.getNoticias().then(function (data) {\n  // faça o que quiser com o retorno  \n});\n```\n\n```sh\n# creates a browser.js\n$ npm run browser\n```\n\n## Documentação\n\n#### getArtista(nome)\n\u003e 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. ([ver mais](http://api.vagalume.com.br/docs/artistas/))\n\n#### getByTrecho(trecho, [limite])\n\u003e Um dos recursos mais interessantes para buscar letras de músicas é a possibilidade de consultar por trecho. Muitas vezes o usuário não lembra do título da música, por isso, este segmento da API pode retornar as músicas que possúem tal trecho buscado. ([ver mais](http://api.vagalume.com.br/docs/search/#mus))\n\n#### getDiscografia(nome)\n\u003e O Vagalume possui também um banco de dados organizando as discografias (álbuns) de cada artista. Como todas as outras chamadas da API, o retorno é feito por JSON e pode e deve ser feito direto pelo navegador do usuário. ([ver mais](http://api.vagalume.com.br/docs/discografia/))\n\n#### getHotspots()\n\u003e 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. ([ver mais](http://api.vagalume.com.br/docs/hotspot/))\n\n#### getNoticias()\n\u003e Você pode integrar as chamadas das notícias do Vagalume em seu site. Assim, você poderá oferecer um conteúdo bastante atualizados sobre o que acontece no mundo da música. No código abaixo, mostramos as últimas 20 notícias publicadas com informações para link e imagem. ([ver mais](http://api.vagalume.com.br/docs/news/))\n\n#### getImagens()\n\u003e O Vagalume possui também um banco de imagens organizadas por galerias. Disponibilizadas pelo próprio artista no caso como (Divulgação) ou as que os prórpios usuários enviam (Enviadas pelos usuários). ([ver mais](http://api.vagalume.com.br/docs/image/))\n\n#### getRanks()\n\u003e As informações de ranking no Vagalume são constantemente atualizadas e representam a tendência musical conforme milhões de acessos diários a páginas de letras, artistas, álbuns dentre outros. As informações são bem seccionadas, permitindo uso variado e fornecendo inúmeras possibilidades de aplicação em seu projeto.. ([ver mais](http://api.vagalume.com.br/docs/rank/))\n\n## License\n\nMIT © [Gabriel Pedro](https://gpedro.net)\n\n\n[npm-image]: https://badge.fury.io/js/vagalume.svg\n[npm-url]: https://npmjs.org/package/vagalume\n[travis-image]: https://travis-ci.org/gpedro/node-vagalume.svg?branch=master\n[travis-url]: https://travis-ci.org/gpedro/node-vagalume\n[daviddm-image]: https://david-dm.org/gpedro/node-vagalume.svg?theme=shields.io\n[daviddm-url]: https://david-dm.org/gpedro/node-vagalume\n[coverage-image]: https://codeclimate.com/github/gpedro/node-vagalume/badges/coverage.svg\n[coverage-url]: https://codeclimate.com/github/gpedro/node-vagalume/coverage\n[climate-image]: https://codeclimate.com/github/gpedro/node-vagalume/badges/gpa.svg\n[climate-url]: https://codeclimate.com/github/gpedro/node-vagalume\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgpedro%2Fnode-vagalume","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgpedro%2Fnode-vagalume","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgpedro%2Fnode-vagalume/lists"}