10ML Perfume Finder · para programadores
Alternativa à API da Fragrantica: uma API gratuita de perfumes com notas e acordes
Não encontrámos nenhuma API pública para programadores da Fragrantica (verificado a 21 de outubro de 2026). A API do 10ML Fragrance Index é uma alternativa gratuita para os dados que os programadores costumam procurar: pirâmides de notas, acordes, perfumes semelhantes, notas e casas para mais de 6 000 perfumes, em JSON por GET em https://mcp.10ml.com/api/v1. Sem chave de API nem registo.
API REST
https://mcp.10ml.com/api/v1JSON por GET, OpenAPI 3.1. Gratuita, sem chave de API.
A Fragrantica tem uma API? O que verificámos
A 21 de outubro de 2026, a página inicial de fragrantica.com, os menus e o rodapé não tinham ligações para uma API para programadores, documentação de API ou portal de programadores. Além disso, uma pesquisa na web não encontrou documentação de API publicada pela Fragrantica. É tudo o que esta página diz sobre a Fragrantica; consulta o site da própria marca para informações mais recentes.
Os dados sobre perfumes que os programadores costumam procurar, numa API gratuita
| Precisas de | Rota | Devolve |
|---|---|---|
| Pirâmide olfativa e acordes de um perfume | GET /api/v1/perfumes/{name}?format=detailed | Notas de saída, de coração e de fundo, acordes, família, estações e ocasiões; duração e projeção, quando disponíveis no índice |
| Pesquisa por nome, nota ou estilo | GET /api/v1/perfumes?q= | Correspondências ordenadas, com os filtros que compreendeu |
| Perfumes semelhantes | GET /api/v1/similar?perfume= | Ordenados pelas notas e acordes em comum, com indicação do que partilham |
| O cheiro de uma nota | GET /api/v1/notes/{note} | Família, ambiente, combinações e perfumes em que se destaca |
| Uma casa de perfumes | GET /api/v1/houses/{house} | País, ano de fundação, estilo e perfumes de assinatura |
Três outras rotas devolvem alternativas de outras casas, listam casas e permitem pesquisar os guias da 10ML. A página da API de perfumes documenta as oito rotas, com uma resposta real para cada uma.
Experimenta
curl "https://mcp.10ml.com/api/v1/perfumes/Baccarat%20Rouge%20540?format=detailed"const res = await fetch("https://mcp.10ml.com/api/v1/perfumes/Baccarat%20Rouge%20540?format=detailed");
const { perfume } = await res.json();
console.log(perfume.name, perfume.pyramid);import requests
r = requests.get(
"https://mcp.10ml.com/api/v1/perfumes/Baccarat Rouge 540",
params={"format": "detailed"},
timeout=10,
)
perfume = r.json()["perfume"]
print(perfume["name"], perfume["pyramid"])A resposta (ligações omitidas), tal como o servidor a devolve a 21 de outubro de 2026:
{
"found": true,
"exact": true,
"perfume": {
"id": "maison-francis-kurkdjian-baccarat-rouge-540-edp",
"name": "Baccarat Rouge 540",
"house": "Maison Francis Kurkdjian",
"year": 2015,
"gender": "unisex",
"family": "Amber floral",
"accords": ["amber", "woody", "sweet", "floral", "musky"],
"key_notes": ["amberwood", "ambergris", "fir resin", "cedar", "saffron"],
"character": "A glowing, airy amber with a sugared, almost cotton-candy sweetness over mineral woods. Instantly recognisable and famously long-lasting.",
"concentration": "EDP",
"pyramid": {
"top": ["saffron", "jasmine"],
"heart": ["amberwood", "ambergris"],
"base": ["fir resin", "cedar"]
},
"seasons": ["autumn", "winter", "spring"],
"occasions": ["evening", "date night", "special occasion"],
"longevity": 5,
"projection": 5,
"perfumers": ["Francis Kurkdjian"]
},
"source": "10ML Fragrance Index"
}O que o índice inclui — e o que não inclui
O 10ML Fragrance Index reúne mais de 6 000 perfumes, 249 casas e 285 notas, selecionados pelos editores de fragrâncias da 10ML. Não inclui classificações, votos ou críticas da comunidade; se um perfume não estiver no índice, apresenta as correspondências mais próximas. Os índices maiores destacam-se pela abrangência; o benchmark dos servidores MCP gratuitos de perfumes (20 de outubro de 2026) mostra em que ponto.
É gratuito, sem chave de API, conta ou quota para gerir, e todos os endpoints são apenas de leitura. Não há um limite de pedidos fixo, por isso mantém um ritmo razoável, guarda em cache os dados que obténs e avisa-nos antes de fazeres um grande volume de pedidos, através de contact@10ml.com. Se apresentares os dados, identifica-os como 10ML Fragrance Index e inclui uma ligação para a página da API de perfumes.
Para assistentes, não apenas para código
O mesmo índice responde a assistentes através de MCP em https://mcp.10ml.com/mcp. O que é um servidor MCP de perfumes explica quando o deves usar, e a API de recomendação de perfumes abrange perfumes semelhantes e recomendados.
Perguntas
A Fragrantica tem uma API?
Não encontrámos nenhuma. A 21 de outubro de 2026, a página inicial de fragrantica.com, os respetivos menus e o rodapé não têm ligações para uma API para programadores, documentação da API ou portal de programadores; uma pesquisa na web também não encontra documentação da API publicada pela Fragrantica. Consulta o próprio site para ver se há novidades.
O que é uma alternativa gratuita à API da Fragrantica?
A API do 10ML Fragrance Index é uma alternativa gratuita para consultar dados de perfumes em código. Devolve pirâmides de notas, acordes, famílias, estações, ocasiões, perfumes semelhantes, notas e casas para mais de 6 000 perfumes, em JSON por GET em https://mcp.10ml.com/api/v1, documentada em OpenAPI 3.1, sem chave de API nem registo.
Os dados da 10ML são iguais aos da Fragrantica?
É um índice diferente. O 10ML Fragrance Index inclui mais de 6 000 perfumes selecionados pelos editores de fragrâncias da 10ML, com pirâmides de notas, acordes, famílias, estações, ocasiões e perfumes semelhantes, e não tem avaliações nem críticas da comunidade. Compara os campos no exemplo acima com aquilo de que o teu projeto precisa.
Preciso de uma chave de API?
Não. Não precisas de chave, conta nem registo. Não há um limite de pedidos fixo (consulta os termos), por isso guarda em cache os dados que obténs, mantém um ritmo razoável e avisa-nos antes de fazeres um grande volume de pedidos, através de contact@10ml.com.
Posso usar os mesmos dados a partir de um assistente?
Sim. O mesmo índice está disponível como servidor MCP em https://mcp.10ml.com/mcp para Claude, ChatGPT, Cursor e VS Code, com 15 ferramentas apenas de leitura.