API per sviluppatori

Documentazione API

API REST gratuita con risposte JSON strutturate. Chiave API richiesta (gratuita). CORS abilitato. Perfetto per creare app, motori di raccomandazione o alimentare LLM con dati sulle fragranze.

Chiave API richiestaCORS abilitatoRisposte JSON

URL base

https://fraganty.ai

Autenticazione

Tutti gli endpoint API richiedono una chiave API gratuita. Includila in ogni richiesta tramite l'header X-API-Key o il parametro api_key.

Header

X-API-Key: YOUR_API_KEY

Parametro query

?api_key=YOUR_API_KEY

Richiedi la tua chiave API gratuita a [email protected]

llms.txt sitemap.xml

GET/api/perfumes

Elencare e cercare profumi

Parametri

Nome	Tipo	Descrizione
q	string	Cerca per nome
brand	string	Filtra per slug del marchio
page	number	Numero di pagina (predefinito: 1)
limit	number	Risultati per pagina (predefinito: 20, max: 100)

Esempio di richiesta

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

Risposta

{
  "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

Ottenere i dettagli completi del profumo inclusi note, accordi, valutazioni, stagioni e profumi simili

Esempio di richiesta

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

Risposta

{
  "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

Elencare tutti i marchi con il conteggio dei profumi

Parametri

Nome	Tipo	Descrizione
q	string	Cerca marchi per nome

Esempio di richiesta

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

Risposta

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

GET/api/notes

Elencare tutte le note olfattive con il conteggio delle frequenze

Parametri

Nome	Tipo	Descrizione
limit	number	Limita risultati (predefinito: tutti)

Esempio di richiesta

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

Risposta

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

GET/api/perfumers

Elencare tutti i profumieri con il conteggio dei profumi

Esempio di richiesta

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

Risposta

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

GET/api/perfumers/:slug

Ottenere i dettagli del profumiere con i suoi profumi (paginato)

Parametri

Nome	Tipo	Descrizione
page	number	Numero di pagina (predefinito: 1)
limit	number	Risultati per pagina (predefinito: 20)

Esempio di richiesta

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

Risposta

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

Nome

Tipo

Descrizione

string

Cerca per nome

brand

string

Filtra per slug del marchio

page

number

Numero di pagina (predefinito: 1)

limit

number

Risultati per pagina (predefinito: 20, max: 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

Descrizione

string

Cerca marchi per nome

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

Nome

Tipo

Descrizione

limit

number

Limita risultati (predefinito: tutti)

Nome

Tipo

Descrizione

page

number

Numero di pagina (predefinito: 1)

limit

number

Risultati per pagina (predefinito: 20)