API para desenvolvedores
Busque fontes, resolva nomes de fontes pagas e encontre alternativas gratuitas a partir do seu próprio código.
Autenticação
Toda chamada leva uma chave, no cabeçalho Authorization: Bearer <chave> ou x-api-key. Peça a sua pelo e-mail abaixo. Cada chave pode fazer até 60 requisições por minuto, das quais até 10 em POST /identify; acima disso a resposta é 429 com Retry-After.
As respostas são JSON e aceitam chamadas de qualquer origem (CORS).
curl -H "Authorization: Bearer $CHAVE" "https://identificarfonte.com/api/v1/fonts?q=grotesk&license=free"GET /fonts
Busca no catálogo inteiro — Google Fonts, Fontshare e fontes comerciais curadas. Parâmetros: q (texto), category (sans-serif, serif, display, handwriting, monospace), license (free ou paid), sort (popular ou alpha), page e perPage (até 100).
Cada fonte gratuita vem com css, a folha de estilo pronta para usar na web.
GET /fonts/{slug}
Detalhes de uma fonte: fundição, designer, link da fonte, o que a licença permite e, para fontes pagas, as alternativas gratuitas em ordem de semelhança.
curl -H "x-api-key: $CHAVE" "https://identificarfonte.com/api/v1/fonts/gotham"GET /resolve
Transforma um nome como as pessoas escrevem — nome de arquivo, peso no fim, erro de digitação — em uma fonte do catálogo, com as alternativas gratuitas. "Helvetica Neue Bold" vira Helvetica; "Proxmia Nova" vira Proxima Nova quando você informa category=sans-serif. exact: false indica que houve correção de digitação.
curl -H "x-api-key: $CHAVE" "https://identificarfonte.com/api/v1/resolve?name=Proxmia%20Nova&category=sans-serif"POST /identify
Envie a imagem como corpo da requisição (PNG, JPEG, WebP ou GIF, até 4 MB), com o tipo no Content-Type. A resposta traz o texto lido, as características tipográficas e as fontes pagas reconhecidas — cada nome conferido no catálogo, nunca inventado — com a melhor alternativa gratuita.
A comparação geométrica com as fontes gratuitas roda no navegador de quem usa o site, para que a imagem não saia do aparelho; por isso ela não faz parte desta resposta. Use as características (categoria, peso, contraste, largura) para ordenar candidatas gratuitas.
Cada chave tem também uma cota diária de leituras pelo modelo; imagens já lidas voltam do cache e não contam. Com a cota esgotada, a resposta traz limited: true e nenhuma fonte paga.
curl -H "x-api-key: $CHAVE" -H "Content-Type: image/png" \
--data-binary @recorte.png "https://identificarfonte.com/api/v1/identify"Erros
400 pedido malformado · 401 chave ausente ou inválida · 404 fonte desconhecida · 413 imagem grande demais · 415 formato de imagem não suportado · 429 limite de requisições · 503 serviço indisponível. O corpo traz { "error": "<código>" }.