API para programadores

Documentação da API

API REST gratuita com respostas JSON estruturadas. Chave API necessária (gratuita). CORS ativado. Perfeito para criar aplicações, motores de recomendação ou alimentar LLMs com dados de fragrâncias.

Chave API necessáriaCORS ativadoRespostas JSON

URL base

https://fraganty.ai

Autenticação

Todos os endpoints da API requerem uma chave API gratuita. Inclua-a em cada requisição via cabeçalho X-API-Key ou parâmetro api_key.

Cabeçalho

X-API-Key: YOUR_API_KEY

Parâmetro de consulta

?api_key=YOUR_API_KEY

Solicite sua chave API gratuita em [email protected]

llms.txt sitemap.xml

GET/api/perfumes

Listar e pesquisar perfumes

Parâmetros

Nome	Tipo	Descrição
q	string	Pesquisar por nome
brand	string	Filtrar por slug da marca
page	number	Número da página (predefinido: 1)
limit	number	Resultados por página (predefinido: 20, máx: 100)

Exemplo de pedido

curl -H "X-API-Key: YOUR_KEY" https://fraganty.ai/api/perfumes?q=rose&limit=5

Resposta

{
  "data": [
    {
      "id": "rose-goldea-kathleen-kye-edition",
      "name": "Rose Goldea Kathleen Kye Edition",
      "brand": "Bvlgari",
      "year": 2021,
      "rating": 4.62,
      "concentration": null,
      "image": "https://img.fraganty.ai/perfume/64818.jpg",
      "buyUrl": "https://fraganty.ai/goto/rose-goldea-kathleen-kye-edition",
      "accords": [
        { "name": "Rose", "strength": 100, "color": "#C4647C" },
        { "name": "Floral", "strength": 79, "color": "#9E3B52" }
      ]
    }
  ],
  "total": 2460,
  "page": 1,
  "pages": 492
}

GET/api/perfumes/:slug

Obter detalhes completos do perfume, incluindo notas, acordes, avaliações, estações e perfumes semelhantes

Exemplo de pedido

curl -H "X-API-Key: YOUR_KEY" https://fraganty.ai/api/perfumes/bleu-de-chanel-eau-de-parfum

Resposta

{
  "id": "bleu-de-chanel-eau-de-parfum",
  "name": "Bleu de Chanel Eau de Parfum",
  "brand": "Chanel",
  "year": 2014,
  "rating": 4.21,
  "concentration": "Eau de Parfum",
  "gender": "masculine",
  "description": "...",
  "buyUrl": "https://fraganty.ai/goto/bleu-de-chanel-eau-de-parfum",
  "notes": {
    "top": [{ "name": "Lemon", "intensity": 80 }],
    "middle": [{ "name": "Cedar", "intensity": 90 }],
    "base": [{ "name": "Sandalwood", "intensity": 85 }]
  },
  "accords": [...],
  "seasons": { "winter": 45, "spring": 60, "summer": 30, "fall": 65 },
  "dayNight": { "day": 55, "night": 70 },
  "similarPerfumes": [...],
  "perfumers": [{ "name": "Olivier Polge" }]
}

GET/api/brands

Listar todas as marcas com contagem de perfumes

Parâmetros

Nome	Tipo	Descrição
q	string	Pesquisar marcas por nome

Exemplo de pedido

curl -H "X-API-Key: YOUR_KEY" https://fraganty.ai/api/brands

Resposta

{
  "data": [
    { "name": "Guerlain", "slug": "Guerlain", "count": 412 },
    { "name": "Dior", "slug": "Dior", "count": 312 },
    { "name": "Chanel", "slug": "Chanel", "count": 248 }
  ],
  "total": 6619
}

GET/api/notes

Listar todas as notas olfativas com contagens de frequência

Parâmetros

Nome	Tipo	Descrição
limit	number	Limitar resultados (predefinido: todos)

Exemplo de pedido

curl -H "X-API-Key: YOUR_KEY" https://fraganty.ai/api/notes?limit=5

Resposta

{
  "data": [
    { "name": "Musk", "count": 3097 },
    { "name": "Bergamot", "count": 2498 },
    { "name": "Rose", "count": 2460 }
  ],
  "total": 981
}

GET/api/perfumers

Listar todos os perfumistas com contagem de perfumes

Exemplo de pedido

curl -H "X-API-Key: YOUR_KEY" https://fraganty.ai/api/perfumers

Resposta

{
  "data": [
    { "name": "Alberto Morillas", "slug": "alberto-morillas", "count": 45 },
    { "name": "Olivier Polge", "slug": "olivier-polge", "count": 38 }
  ],
  "total": 358
}

GET/api/perfumers/:slug

Obter detalhes do perfumista com os seus perfumes (paginado)

Parâmetros

Nome	Tipo	Descrição
page	number	Número da página (predefinido: 1)
limit	number	Resultados por página (predefinido: 20)

Exemplo de pedido

curl -H "X-API-Key: YOUR_KEY" https://fraganty.ai/api/perfumers/alberto-morillas

Resposta

{
  "name": "Alberto Morillas",
  "slug": "alberto-morillas",
  "perfumes": {
    "data": [...],
    "total": 45,
    "page": 1,
    "pages": 3
  }
}

Nome

Tipo

Descrição

string

Pesquisar por nome

brand

string

Filtrar por slug da marca

page

number

Número da página (predefinido: 1)

limit

number

Resultados por página (predefinido: 20, máx: 100)

{ "data": [ { "id": "rose-goldea-kathleen-kye-edition", "name": "Rose Goldea Kathleen Kye Edition", "brand": "Bvlgari", "year": 2021, "rating": 4.62, "concentration": null, "image": "https://img.fraganty.ai/perfume/64818.jpg", "buyUrl": "https://fraganty.ai/goto/rose-goldea-kathleen-kye-edition", "accords": [ { "name": "Rose", "strength": 100, "color": "#C4647C" }, { "name": "Floral", "strength": 79, "color": "#9E3B52" } ] } ], "total": 2460, "page": 1, "pages": 492 }

{ "id": "bleu-de-chanel-eau-de-parfum", "name": "Bleu de Chanel Eau de Parfum", "brand": "Chanel", "year": 2014, "rating": 4.21, "concentration": "Eau de Parfum", "gender": "masculine", "description": "...", "buyUrl": "https://fraganty.ai/goto/bleu-de-chanel-eau-de-parfum", "notes": { "top": [{ "name": "Lemon", "intensity": 80 }], "middle": [{ "name": "Cedar", "intensity": 90 }], "base": [{ "name": "Sandalwood", "intensity": 85 }] }, "accords": [...], "seasons": { "winter": 45, "spring": 60, "summer": 30, "fall": 65 }, "dayNight": { "day": 55, "night": 70 }, "similarPerfumes": [...], "perfumers": [{ "name": "Olivier Polge" }] }

Nome

Tipo

Descrição

string

Pesquisar marcas por nome

{ "data": [ { "name": "Guerlain", "slug": "Guerlain", "count": 412 }, { "name": "Dior", "slug": "Dior", "count": 312 }, { "name": "Chanel", "slug": "Chanel", "count": 248 } ], "total": 6619 }

Nome

Tipo

Descrição

limit

number

Limitar resultados (predefinido: todos)

Nome

Tipo

Descrição

page

number

Número da página (predefinido: 1)

limit

number

Resultados por página (predefinido: 20)