Documentação

Guia de integração e referência da API do Cifralize

Embed - Incorporar Cifras

Você pode incorporar qualquer cifra do Cifralize em outro site usando a tag <iframe>. Basta utilizar a URL do embed com o artista e a música desejados.

// Formato básico
<iframe src="https://cifralize.com.br/embed/artista/musica"
    width="100%" height="400" frameborder="0"></iframe>
Parâmetros do Embed

Personalize a exibição das cifras utilizando parâmetros na URL:

Parâmetro Tipo Descrição Exemplo
transpose Integer Número de semitons para transpor (positivo sobe, negativo desce) ?transpose=2
layout String Tema visual: light ou dark ?layout=dark
show_title Boolean Exibir ou ocultar o título da música ?show_title=false
show_artist Boolean Exibir ou ocultar o nome do artista ?show_artist=false
Exemplos de Uso

Transpor 2 semitons com tema escuro:

<iframe src="https://cifralize.com.br/embed/artista/musica?transpose=2&layout=dark"
    width="100%" height="400" frameborder="0"></iframe>

Sem título e sem artista:

<iframe src="https://cifralize.com.br/embed/artista/musica?show_title=false&show_artist=false"
    width="100%" height="400" frameborder="0"></iframe>
Endpoints da API

Endpoints públicos disponíveis para integração:

GET /embed/:artista/:musica

Retorna a cifra formatada para incorporação via iframe

GET /search?q=:query&format=json

Busca músicas, artistas e playlists. Retorna resultados em JSON

GET /autocomplete?q=:query

Autocompletar para campo de busca. Retorna sugestões em JSON

GET /:artista/:musica

Página pública da cifra com transposição via parâmetro tom

Observações
Voltar para Sobre