API Développeur
API REST gratuite avec réponses JSON structurées. Clé API requise (gratuite). CORS activé. Parfait pour créer des applications, des moteurs de recommandation ou alimenter des LLMs avec des données de parfums.
URL de base
https://fraganty.aiTous les endpoints de l'API nécessitent une clé API gratuite. Incluez-la dans chaque requête via l'en-tête X-API-Key ou le paramètre api_key.
En-tête
X-API-Key: YOUR_API_KEYParamètre de requête
?api_key=YOUR_API_KEYDemandez votre clé API gratuite à [email protected]
/api/perfumesLister et rechercher des parfums
Paramètres
| Nom | Type | Description |
|---|---|---|
| q | string | Rechercher par nom |
| brand | string | Filtrer par slug de marque |
| page | number | Numéro de page (par défaut : 1) |
| limit | number | Résultats par page (par défaut : 20, max : 100) |
Exemple de requête
Réponse
{
"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
}/api/perfumes/:slugObtenir les détails complets d'un parfum, y compris notes, accords, évaluations, saisons et parfums similaires
Exemple de requête
Réponse
{
"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" }]
}/api/brandsLister toutes les marques avec le nombre de parfums
Paramètres
| Nom | Type | Description |
|---|---|---|
| q | string | Rechercher des marques par nom |
Exemple de requête
Réponse
{
"data": [
{ "name": "Guerlain", "slug": "Guerlain", "count": 412 },
{ "name": "Dior", "slug": "Dior", "count": 312 },
{ "name": "Chanel", "slug": "Chanel", "count": 248 }
],
"total": 6619
}/api/notesLister toutes les notes olfactives avec leur fréquence
Paramètres
| Nom | Type | Description |
|---|---|---|
| limit | number | Limiter les résultats (par défaut : tous) |
Exemple de requête
Réponse
{
"data": [
{ "name": "Musk", "count": 3097 },
{ "name": "Bergamot", "count": 2498 },
{ "name": "Rose", "count": 2460 }
],
"total": 981
}/api/perfumersLister tous les parfumeurs avec le nombre de parfums
Exemple de requête
Réponse
{
"data": [
{ "name": "Alberto Morillas", "slug": "alberto-morillas", "count": 45 },
{ "name": "Olivier Polge", "slug": "olivier-polge", "count": 38 }
],
"total": 358
}/api/perfumers/:slugObtenir les détails d'un parfumeur avec ses parfums (paginé)
Paramètres
| Nom | Type | Description |
|---|---|---|
| page | number | Numéro de page (par défaut : 1) |
| limit | number | Résultats par page (par défaut : 20) |
Exemple de requête
Réponse
{
"name": "Alberto Morillas",
"slug": "alberto-morillas",
"perfumes": {
"data": [...],
"total": 45,
"page": 1,
"pages": 3
}
}