API pro vývojáře

Dokumentace API

Bezplatné REST API se strukturovanými JSON odpověďmi. Vyžadován API klíč (zdarma). CORS povoleno. Ideální pro tvorbu aplikací, doporučovacích systémů nebo napájení LLM daty o parfémech.

Vyžadován API klíčCORS povolenoJSON odpovědi

Základní URL

https://fraganty.ai

Ověření

Všechny API endpointy vyžadují bezplatný API klíč. Přiložte ho ke každému požadavku přes hlavičku X-API-Key nebo parametr api_key.

Hlavička

X-API-Key: YOUR_API_KEY

Parametr dotazu

?api_key=YOUR_API_KEY

Požádejte o bezplatný API klíč na [email protected]

llms.txt sitemap.xml

GET/api/perfumes

Vypsat a vyhledat parfémy

Parametry

Název	Typ	Popis
q	string	Hledat podle názvu
brand	string	Filtrovat podle slugu značky
page	number	Číslo stránky (výchozí: 1)
limit	number	Výsledků na stránku (výchozí: 20, max: 100)

Příklad požadavku

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

Odpověď

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

Získat kompletní detaily parfému včetně not, akordů, hodnocení, sezón a podobných parfémů

Příklad požadavku

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

Odpověď

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

Vypsat všechny značky s počtem parfémů

Parametry

Název	Typ	Popis
q	string	Hledat značky podle názvu

Příklad požadavku

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

Odpověď

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

GET/api/notes

Vypsat všechny vonné noty s počty výskytů

Parametry

Název	Typ	Popis
limit	number	Omezit výsledky (výchozí: vše)

Příklad požadavku

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

Odpověď

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

GET/api/perfumers

Vypsat všechny parfuméry s počtem parfémů

Příklad požadavku

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

Odpověď

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

GET/api/perfumers/:slug

Získat detaily parfuméra s jeho parfémy (stránkované)

Parametry

Název	Typ	Popis
page	number	Číslo stránky (výchozí: 1)
limit	number	Výsledků na stránku (výchozí: 20)

Příklad požadavku

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

Odpověď

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

Název

Typ

Popis

string

Hledat podle názvu

brand

string

Filtrovat podle slugu značky

page

number

Číslo stránky (výchozí: 1)

limit

number

Výsledků na stránku (výchozí: 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" }] }

Název

Typ

Popis

string

Hledat značky podle názvu

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

Název

Typ

Popis

limit

number

Omezit výsledky (výchozí: vše)

Název

Typ

Popis

page

number

Číslo stránky (výchozí: 1)

limit

number

Výsledků na stránku (výchozí: 20)