API pública · v1.0.0 · OpenAPI 3.1.0

A fornada em JSON.

Só leitura, sem cadastro obrigatório e com CORS aberto. Sem chave já responde; com chave o limite sobe de 10 para 60 requisições por minuto.

Visão geral

O Biscoiteiro é um ranking brasileiro de sites onde quem paga mais fica no topo; cada lance derrete até zero em 7 dias. Esta API entrega o mesmo que o site mostra: o ranking de agora, os dados de cada link, a fornada congelada de cada dia e o Hall da Fama.

Tudo é somente leitura (GET) e responde JSON em UTF-8. Toda resposta de sucesso vem no envelope { dados, gerado_em }; todo erro vem como { erro: { codigo, mensagem } }. CORS é aberto: dá para chamar direto do navegador.

Convenções: campos em snake_case e em português; datas em ISO 8601 UTC; dinheiro em centavos inteiros, arredondado para baixo (85714 = R$ 857,14); durações em segundos inteiros. Só aparecem links ativos e só texto que já passou pela moderação.

Estabilidade: a v1 pode ganhar campos novos sem aviso, então ignore o que você não conhece. Nenhum campo existente muda de nome, muda de tipo ou some; isso só numa v2.

Endereço base e arquivo OpenAPI
O quê	Onde
Endereço base	https://biscoiteiro.com.br
Documento OpenAPI	https://biscoiteiro.com.br/openapi.json
Regras do ranking	Como o ranking funciona: lances, decaimento de 7 dias e desempate

Comece por aqui

curl https://biscoiteiro.com.br/api/v1/ranking

Autenticação

A chave é opcional. Sem ela a API responde igual, só com um limite menor. Com ela o limite é seu, e não do IP de onde você chama. A chave tem o formato bsc_... e pode ir de dois jeitos:

Formas de enviar a chave
Cabeçalho	Como
Authorization	Chave de API no cabeçalho `Authorization: Bearer bsc_...`. É a forma recomendada.
X-API-Key	A mesma chave no cabeçalho `X-API-Key: bsc_...`, para clientes que não deixam mexer no `Authorization`. Se os dois vierem, vale o `Authorization`.

Como gerar a sua chave

Entre no painel da sua conta. O login é por link mágico no e-mail, sem senha.
Na parte de chaves de API, crie uma chave e dê um nome que diga onde ela vai ser usada.
Copie na hora. A chave aparece uma vez só: no banco fica apenas o hash dela.
Vazou ou não usa mais? Revogue no mesmo painel. Chave revogada passa a responder 401.

Gerar minha chave

Chave errada não vira requisição anônima: a resposta é 401, para você descobrir o problema no primeiro teste e não quando o limite menor estourar.

Limites

Com chave

60 req/minuto

por chave

Sem chave

10 req/minuto

por IP

A janela é fixa: vira a cada minuto cheio do relógio, e a contagem zera junto. Toda resposta diz quanto ainda cabe. O selo não entra nessa conta.

Cabeçalhos de resposta
Cabeçalho	O que diz
X-RateLimit-Limit	Quantas requisições cabem na janela de um minuto: 60 com chave, 10 sem.
X-RateLimit-Remaining	Quantas ainda cabem na janela atual, já contando esta.
X-RateLimit-Reset	Em quantos segundos a janela atual vira e a contagem zera.
Retry-After	Só no 429: em quantos segundos dá para tentar de novo.
WWW-Authenticate	Só no 401: o esquema de autenticação esperado.

Endpoints

GET /api/v1/rankingRanking atual
GET /api/v1/ranking/{data}Ranking congelado de um dia
GET /api/v1/links/{slug}Dados, posição e estatísticas de um link
GET /api/v1/hall-da-famaReinados e recordes

GET/api/v1/ranking

Ranking atual

A fornada de agora, do #1 para baixo: posição, valor efetivo, quando cada link zera e quanto custa passar cada um. O valor efetivo derrete o tempo todo, então a resposta sai de um cache de 5 segundos; gerado_em diz de quando é a foto.

Parâmetros de /api/v1/ranking
Parâmetro	Onde	Tipo	Descrição
limite	query	inteiro (padrão 100)	Quantos links devolver, a partir do #1. `total` sempre diz quantos existem no ranking.

curl

curl https://biscoiteiro.com.br/api/v1/ranking

curl com chave

curl "https://biscoiteiro.com.br/api/v1/ranking?limite=10" \
  -H "Authorization: Bearer bsc_SUA_CHAVE"

Resposta 200 · application/json

{
  "dados": {
    "total": 42,
    "reinando_desde": "2026-09-17T13:05:00.000Z",
    "itens": [
      {
        "posicao": 1,
        "slug": "sualoja-com-br",
        "titulo": "Sua Loja",
        "descricao": "Camisetas que não desbotam, entrega pra todo o Brasil.",
        "dominio": "sualoja.com.br",
        "url": "https://sualoja.com.br",
        "instagram": "sualoja",
        "favicon_url": "https://biscoiteiro.com.br/imagens/favicons/0b9d2f6e-6c1d-4a63-9f39-5d2a0c1e7a11.png",
        "valor_efetivo_centavos": 85714,
        "zera_em": "2026-09-24T13:05:00.000Z",
        "ultimo_lance_em": "2026-09-17T13:05:00.000Z",
        "custo_para_passar_centavos": 85900,
        "cliques": 312,
        "pagina_url": "https://biscoiteiro.com.br/p/sualoja-com-br"
      },
      {
        "posicao": 2,
        "slug": "instagram-fulano",
        "titulo": "@fulano",
        "descricao": null,
        "dominio": "instagram.com",
        "url": "https://instagram.com/fulano",
        "instagram": "fulano",
        "favicon_url": null,
        "valor_efetivo_centavos": 20100,
        "zera_em": "2026-09-25T09:40:12.000Z",
        "ultimo_lance_em": "2026-09-18T09:40:12.000Z",
        "custo_para_passar_centavos": 20200,
        "cliques": 57,
        "pagina_url": "https://biscoiteiro.com.br/p/instagram-fulano"
      }
    ]
  },
  "gerado_em": "2026-09-18T15:00:02.000Z"
}

Campos da resposta (19)

Campos da resposta de /api/v1/ranking
Campo	Tipo	Descrição
dados	objeto	O ranking de agora.
dados.total	inteiro	Quantos links estão no ranking agora, independente de `limite`.
dados.reinando_desde	data-hora \| null	Desde quando o #1 atual está no trono. `null` com o ranking vazio.
dados.itens	objeto[]	Do #1 para baixo.
dados.itens[].posicao	inteiro	1 é o Biscoiteiro-mor.
dados.itens[].slug	string	Identificador público do link.
dados.itens[].titulo	string	Nome do site, já moderado.
dados.itens[].descricao	string \| null	Descrição moderada, quando existe.
dados.itens[].dominio	string	Domínio sem `www`.
dados.itens[].url	url	Endereço normalizado do site.
dados.itens[].instagram	string \| null	Usuário do Instagram, sem @.
dados.itens[].favicon_url	url \| null	Favicon guardado pelo Biscoiteiro (PNG 64×64).
dados.itens[].valor_efetivo_centavos	inteiro	Soma dos lances vivos, já derretidos até `gerado_em`.
dados.itens[].zera_em	data-hora	Quando o link sai do ranking se ninguém reforçar.
dados.itens[].ultimo_lance_em	data-hora	Confirmação do lance mais recente.
dados.itens[].custo_para_passar_centavos	inteiro	Quanto um link novo paga agora para ficar logo acima deste: R$ 1 acima do valor efetivo, no mínimo R$ 10.
dados.itens[].cliques	inteiro	Cliques de saída contados pelo Biscoiteiro (no máximo 1 por IP a cada 24 h).
dados.itens[].pagina_url	url	Página do link no Biscoiteiro.
gerado_em	data-hora	De quando é a foto do ranking (cache de 5 segundos).

Respostas

200O ranking atual.
400Parâmetro de rota ou de query fora do formato. A mensagem diz qual e por quê.
401Veio uma chave e ela não vale: formato errado, desconhecida ou revogada. A API não cai para o limite anônimo em silêncio; para usar sem chave, não mande o cabeçalho.
429Estourou o limite da janela de um minuto. Espere o Retry-After e tente de novo.
500Falha do nosso lado. Pode tentar de novo.

GET/api/v1/ranking/{data}

Ranking congelado de um dia

A fornada fechada de um dia (o mesmo conteúdo de /ranking/AAAA-MM-DD no site e do carrossel do Instagram), com os números do dia. A data é a de Brasília. Link que saiu do ar depois some da lista, e as posições não são renumeradas: o buraco fica, inclusive no #1 (a lista pode começar no 2).

Parâmetros de /api/v1/ranking/{data}
Parâmetro	Onde	Tipo	Descrição
data *	rota	data	Dia da fornada, no calendário de Brasília, no formato `AAAA-MM-DD`.

curl

curl https://biscoiteiro.com.br/api/v1/ranking/2026-09-17

curl com chave

curl https://biscoiteiro.com.br/api/v1/ranking/2026-09-17 \
  -H "Authorization: Bearer bsc_SUA_CHAVE"

Resposta 200 · application/json

{
  "dados": {
    "data": "2026-09-17",
    "fechada_em": "2026-09-17T23:00:04.000Z",
    "pagina_url": "https://biscoiteiro.com.br/ranking/2026-09-17",
    "itens": [
      {
        "posicao": 1,
        "slug": "sualoja-com-br",
        "titulo": "Sua Loja",
        "dominio": "sualoja.com.br",
        "url": "https://sualoja.com.br",
        "instagram": "sualoja",
        "favicon_url": "https://biscoiteiro.com.br/imagens/favicons/0b9d2f6e-6c1d-4a63-9f39-5d2a0c1e7a11.png",
        "valor_efetivo_centavos": 94100,
        "pagina_url": "https://biscoiteiro.com.br/p/sualoja-com-br"
      },
      {
        "posicao": 2,
        "slug": "meusaas-com-br",
        "titulo": "MeuSaaS",
        "dominio": "meusaas.com.br",
        "url": "https://meusaas.com.br",
        "instagram": null,
        "favicon_url": null,
        "valor_efetivo_centavos": 31250,
        "pagina_url": "https://biscoiteiro.com.br/p/meusaas-com-br"
      }
    ],
    "numeros": {
      "lances_no_dia": 18,
      "trocas_de_trono": 3,
      "maior_lance_centavos": 100000,
      "maior_subida": {
        "slug": "meusaas-com-br",
        "titulo": "MeuSaaS",
        "posicoes": 9
      },
      "reinou_hoje_segundos": 35700
    }
  },
  "gerado_em": "2026-09-18T15:00:02.000Z"
}

Campos da resposta (24)

Campos da resposta de /api/v1/ranking/{data}
Campo	Tipo	Descrição
dados	objeto	A fornada fechada de um dia.
dados.data	data	Dia da fornada (Brasília).
dados.fechada_em	data-hora	Instante em que a fornada foi congelada.
dados.pagina_url	url	Página do arquivo desse dia no site.
dados.itens	objeto[]	Do #1 para baixo, como fechou.
dados.itens[].posicao	inteiro	Posição no fechamento.
dados.itens[].slug	string	Identificador público do link.
dados.itens[].titulo	string	Nome do site, já moderado.
dados.itens[].dominio	string	Domínio sem `www`.
dados.itens[].url	url	Endereço normalizado do site.
dados.itens[].instagram	string \| null	Usuário do Instagram, sem @.
dados.itens[].favicon_url	url \| null	Favicon guardado pelo Biscoiteiro.
dados.itens[].valor_efetivo_centavos	inteiro	Valor efetivo no instante do fechamento.
dados.itens[].pagina_url	url	Página do link no Biscoiteiro.
dados.numeros	objeto	Os números daquele dia, congelados junto com a fornada.
dados.numeros.lances_no_dia	inteiro	Lances confirmados naquele dia.
dados.numeros.trocas_de_trono	inteiro	Quantas vezes o #1 mudou de dono.
dados.numeros.maior_lance_centavos	inteiro	O maior lance do dia.
dados.numeros.maior_subida	objeto \| null	Quem mais subiu de posição no dia.
dados.numeros.maior_subida.slug	string	Identificador público do link.
dados.numeros.maior_subida.titulo	string	Nome do site, já moderado.
dados.numeros.maior_subida.posicoes	inteiro	Quantas posições subiu.
dados.numeros.reinou_hoje_segundos	inteiro	Quanto tempo o #1 do fechamento passou no trono naquele dia. Zero se o #1 daquele dia saiu do ar depois.
gerado_em	data-hora	Data e hora em ISO 8601, sempre em UTC.

Respostas

200A fornada daquele dia.
400Parâmetro de rota ou de query fora do formato. A mensagem diz qual e por quê.
401Veio uma chave e ela não vale: formato errado, desconhecida ou revogada. A API não cai para o limite anônimo em silêncio; para usar sem chave, não mande o cabeçalho.
404Não há fornada fechada nessa data: o dia ainda não fechou ou é anterior ao lançamento.
429Estourou o limite da janela de um minuto. Espere o Retry-After e tente de novo.
500Falha do nosso lado. Pode tentar de novo.

GET/api/v1/links/{slug}

Dados, posição e estatísticas de um link

Tudo que a página /p/{slug} mostra: os dados públicos do link, a posição e o valor efetivo de agora, e as estatísticas históricas. Link que já zerou continua respondendo, com no_ranking: false. Link pendente de moderação, removido ou bloqueado responde 404, igual a link que nunca existiu.

Parâmetros de /api/v1/links/{slug}
Parâmetro	Onde	Tipo	Descrição
slug *	rota	string	Identificador do link: o mesmo da URL `/p/{slug}` no site.

curl

curl https://biscoiteiro.com.br/api/v1/links/sualoja-com-br

curl com chave

curl https://biscoiteiro.com.br/api/v1/links/sualoja-com-br \
  -H "Authorization: Bearer bsc_SUA_CHAVE"

Resposta 200 · application/json

{
  "dados": {
    "slug": "sualoja-com-br",
    "titulo": "Sua Loja",
    "descricao": "Camisetas que não desbotam, entrega pra todo o Brasil.",
    "dominio": "sualoja.com.br",
    "url": "https://sualoja.com.br",
    "instagram": "sualoja",
    "favicon_url": "https://biscoiteiro.com.br/imagens/favicons/0b9d2f6e-6c1d-4a63-9f39-5d2a0c1e7a11.png",
    "pagina_url": "https://biscoiteiro.com.br/p/sualoja-com-br",
    "selo_url": "https://biscoiteiro.com.br/selo/sualoja-com-br.svg",
    "criado_em": "2026-09-02T18:22:41.000Z",
    "cliques": 312,
    "no_ranking": true,
    "posicao": 1,
    "valor_efetivo_centavos": 85714,
    "zera_em": "2026-09-24T13:05:00.000Z",
    "custo_para_passar_centavos": 85900,
    "estatisticas": {
      "numero_de_reinados": 4,
      "tempo_total_no_trono_segundos": 412380,
      "maior_reinado_continuo_segundos": 187200,
      "dias_no_trono": 6,
      "melhor_posicao": 1,
      "maior_lance_centavos": 100000,
      "total_pago_centavos": 345000,
      "numero_de_lances": 7,
      "primeiro_lance_em": "2026-09-02T18:25:10.000Z"
    }
  },
  "gerado_em": "2026-09-18T15:00:02.000Z"
}

Campos da resposta (28)

Campos da resposta de /api/v1/links/{slug}
Campo	Tipo	Descrição
dados	objeto	Dados públicos de um link, com a situação dele no ranking de agora.
dados.slug	string	Identificador público do link.
dados.titulo	string	Nome do site, já moderado.
dados.descricao	string \| null	Descrição moderada, quando existe.
dados.dominio	string	Domínio sem `www`.
dados.url	url	Endereço normalizado do site.
dados.instagram	string \| null	Usuário do Instagram, sem @.
dados.favicon_url	url \| null	Favicon guardado pelo Biscoiteiro (PNG 64×64).
dados.pagina_url	url	Página do link no Biscoiteiro.
dados.selo_url	url	Selo SVG deste link.
dados.criado_em	data-hora	Quando o link entrou no Biscoiteiro.
dados.cliques	inteiro	Cliques de saída contados pelo Biscoiteiro.
dados.no_ranking	booleano	`false` quando o valor efetivo já zerou.
dados.posicao	inteiro \| null	Posição de agora; `null` fora do ranking.
dados.valor_efetivo_centavos	inteiro	0 fora do ranking.
dados.zera_em	data-hora \| null	Quando sai do ranking; `null` se já saiu.
dados.custo_para_passar_centavos	inteiro \| null	Quanto um link novo paga agora para ficar logo acima deste; `null` fora do ranking.
dados.estatisticas	objeto	Números históricos do link: os mesmos da página dele no site.
dados.estatisticas.numero_de_reinados	inteiro	Quantas vezes tomou o #1.
dados.estatisticas.tempo_total_no_trono_segundos	inteiro	Soma de todos os reinados, contando o que está em andamento.
dados.estatisticas.maior_reinado_continuo_segundos	inteiro	O reinado mais longo sem perder o trono.
dados.estatisticas.dias_no_trono	inteiro	Dias distintos (Brasília) em que passou pelo #1.
dados.estatisticas.melhor_posicao	inteiro \| null	Melhor posição já registrada; `null` se ainda não saiu em nenhuma foto do ranking.
dados.estatisticas.maior_lance_centavos	inteiro	O maior lance confirmado do link.
dados.estatisticas.total_pago_centavos	inteiro	Soma de todos os lances confirmados.
dados.estatisticas.numero_de_lances	inteiro	Quantos lances confirmados o link já teve.
dados.estatisticas.primeiro_lance_em	data-hora \| null	Confirmação do primeiro lance.
gerado_em	data-hora	Data e hora em ISO 8601, sempre em UTC.

Respostas

200O link.
400Parâmetro de rota ou de query fora do formato. A mensagem diz qual e por quê.
401Veio uma chave e ela não vale: formato errado, desconhecida ou revogada. A API não cai para o limite anônimo em silêncio; para usar sem chave, não mande o cabeçalho.
404Não existe link ativo com esse slug.
429Estourou o limite da janela de um minuto. Espere o Retry-After e tente de novo.
500Falha do nosso lado. Pode tentar de novo.

GET/api/v1/hall-da-fama

Reinados e recordes

Todos os links que já foram #1, ordenados por tempo total no trono, e os três recordes da casa: maior reinado contínuo, maior lance e mais reinados. O reinado em andamento conta até agora. Recorde cujo dono saiu do ar vem null.

curl

curl https://biscoiteiro.com.br/api/v1/hall-da-fama

curl com chave

curl https://biscoiteiro.com.br/api/v1/hall-da-fama \
  -H "Authorization: Bearer bsc_SUA_CHAVE"

Resposta 200 · application/json

{
  "dados": {
    "total": 2,
    "itens": [
      {
        "slug": "sualoja-com-br",
        "titulo": "Sua Loja",
        "dominio": "sualoja.com.br",
        "favicon_url": "https://biscoiteiro.com.br/imagens/favicons/0b9d2f6e-6c1d-4a63-9f39-5d2a0c1e7a11.png",
        "numero_de_reinados": 4,
        "tempo_total_no_trono_segundos": 412380,
        "maior_reinado_continuo_segundos": 187200,
        "maior_lance_centavos": 100000,
        "reinando_agora": true,
        "pagina_url": "https://biscoiteiro.com.br/p/sualoja-com-br"
      },
      {
        "slug": "meusaas-com-br",
        "titulo": "MeuSaaS",
        "dominio": "meusaas.com.br",
        "favicon_url": null,
        "numero_de_reinados": 6,
        "tempo_total_no_trono_segundos": 96400,
        "maior_reinado_continuo_segundos": 40120,
        "maior_lance_centavos": 150000,
        "reinando_agora": false,
        "pagina_url": "https://biscoiteiro.com.br/p/meusaas-com-br"
      }
    ],
    "recordes": {
      "maior_reinado": {
        "slug": "sualoja-com-br",
        "titulo": "Sua Loja",
        "duracao_segundos": 187200
      },
      "maior_lance": {
        "slug": "meusaas-com-br",
        "titulo": "MeuSaaS",
        "valor_centavos": 150000
      },
      "mais_reinados": {
        "slug": "meusaas-com-br",
        "titulo": "MeuSaaS",
        "quantidade": 6
      }
    }
  },
  "gerado_em": "2026-09-18T15:00:02.000Z"
}

Campos da resposta (27)

Campos da resposta de /api/v1/hall-da-fama
Campo	Tipo	Descrição
dados	objeto	Todos que já foram #1 e os recordes da casa.
dados.total	inteiro	Quantos links já foram #1.
dados.itens	objeto[]	Ordenados por tempo total no trono, do maior para o menor.
dados.itens[].slug	string	Identificador público do link.
dados.itens[].titulo	string	Nome do site, já moderado.
dados.itens[].dominio	string	Domínio sem `www`.
dados.itens[].favicon_url	url \| null	Favicon guardado pelo Biscoiteiro.
dados.itens[].numero_de_reinados	inteiro	Quantas vezes tomou o #1.
dados.itens[].tempo_total_no_trono_segundos	inteiro	Soma de todos os reinados, contando o que está em andamento.
dados.itens[].maior_reinado_continuo_segundos	inteiro	O reinado mais longo sem perder o trono.
dados.itens[].maior_lance_centavos	inteiro	O maior lance confirmado do link.
dados.itens[].reinando_agora	booleano	`true` para o Biscoiteiro-mor do momento.
dados.itens[].pagina_url	url	Página do link no Biscoiteiro.
dados.recordes	objeto	Os três recordes da casa.
dados.recordes.maior_reinado	objeto \| null	O reinado contínuo mais longo da história.
dados.recordes.maior_reinado.slug	string	Identificador público do link.
dados.recordes.maior_reinado.titulo	string	Nome do site, já moderado.
dados.recordes.maior_reinado.duracao_segundos	inteiro	Duração do reinado recordista.
dados.recordes.maior_lance	objeto \| null	O maior lance já confirmado.
dados.recordes.maior_lance.slug	string	Identificador público do link.
dados.recordes.maior_lance.titulo	string	Nome do site, já moderado.
dados.recordes.maior_lance.valor_centavos	inteiro	Valor do lance recordista.
dados.recordes.mais_reinados	objeto \| null	Quem mais vezes tomou o trono.
dados.recordes.mais_reinados.slug	string	Identificador público do link.
dados.recordes.mais_reinados.titulo	string	Nome do site, já moderado.
dados.recordes.mais_reinados.quantidade	inteiro	Número de reinados.
gerado_em	data-hora	Data e hora em ISO 8601, sempre em UTC.

Respostas

200O Hall da Fama.
401Veio uma chave e ela não vale: formato errado, desconhecida ou revogada. A API não cai para o limite anônimo em silêncio; para usar sem chave, não mande o cabeçalho.
429Estourou o limite da janela de um minuto. Espere o Retry-After e tente de novo.
500Falha do nosso lado. Pode tentar de novo.

Erros

Todo erro tem o mesmo corpo. Programe contra o codigo, que é estável; a mensagem é para gente ler e pode mudar.

Formato do erro

{
  "erro": {
    "codigo": "link_nao_encontrado",
    "mensagem": "Esse link não existe no Biscoiteiro ou não está no ar."
  }
}

Códigos de erro
Status	Código	Quando
400	parametro_invalido	Parâmetro de rota ou de query fora do formato. A mensagem diz qual.
401	chave_invalida	Veio uma chave malformada ou que não existe.
401	chave_revogada	A chave existia e foi revogada no painel.
404	link_nao_encontrado	Não existe link ativo com esse slug.
404	fornada_nao_encontrada	Não há fornada fechada nessa data.
404	rota_nao_encontrada	O caminho não existe na v1.
429	limite_excedido	Estourou o limite do minuto. Espere o `Retry-After`.
500	erro_interno	Falha do nosso lado. Pode tentar de novo.

Selo

Imagem SVG de 200×56 (vetorial: fica nítida em 2x e em qualquer tamanho) para o dono do link colocar no próprio site, dentro de um link para a página dele no Biscoiteiro. Com o link no ranking o selo diz "Estou no #N do Biscoiteiro"; depois que o link zera, "Já estive no Biscoiteiro". Não pede chave e não conta no limite da API; a imagem fica em cache por 5 minutos, então a posição pode demorar esse tanto para mudar.

Troque SEU-SLUG pelo slug do seu link (o final do endereço da sua página, /p/SEU-SLUG) e cole no seu site. O link de volta é para a sua página no Biscoiteiro, onde quem clicou vê a sua posição e pode tentar te passar.

HTML do selo

<a href="https://biscoiteiro.com.br/p/SEU-SLUG">
  <img src="https://biscoiteiro.com.br/selo/SEU-SLUG.svg"
       alt="Estou no ranking do Biscoiteiro" width="200" height="56" loading="lazy">
</a>

HTML do selo · fundo escuro

<a href="https://biscoiteiro.com.br/p/SEU-SLUG">
  <img src="https://biscoiteiro.com.br/selo/SEU-SLUG.svg?tema=escuro"
       alt="Estou no ranking do Biscoiteiro" width="200" height="56" loading="lazy">
</a>

Parâmetros do selo
Parâmetro	Onde	Descrição
slug	rota	Identificador do link: o mesmo da URL `/p/{slug}` no site.
tema	query	`escuro` troca o fundo para chocolate, para sites de fundo escuro. Qualquer outro valor cai no `claro`.

Respostas do selo
Status	Tipo	Quando
200	image/svg+xml	O selo em SVG.
404	text/plain	Link inexistente ou fora do ar, ou caminho sem o sufixo `.svg`.