API למפתחים
ממשק REST API חינמי עם תגובות JSON מובנות. נדרש מפתח API (חינם). CORS מופעל. מושלם לבניית אפליקציות, מנועי המלצות או הזנת LLMs עם נתוני בשמים.
כתובת בסיס
https://fraganty.aiEvery perfume response includes two image URLs:
image — JPEG with background, ~20-30 KB, always available.imageTransparent — WebP with transparent background, ~15-50 KB. Returns 404 with header X-Fraganty-Nobg-Status: not-processed for perfumes not yet pre-processed — fall back to image.Both URLs are immutable, CDN-cached for 1 year, and CORS-enabled for direct use in browsers and native apps.
כל נקודות הקצה של ה-API דורשות מפתח API חינמי. כלול אותו בכל בקשה דרך כותרת X-API-Key או פרמטר api_key.
כותרת
X-API-Key: YOUR_API_KEYפרמטר שאילתה
?api_key=YOUR_API_KEYבקש את מפתח ה-API החינמי שלך בכתובת api@fraganty.ai
/api/perfumesרשימה וחיפוש בשמים
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
| q | string | חפש לפי שם |
| brand | string | סנן לפי מזהה מותג |
| page | number | מספר עמוד (ברירת מחדל: 1) |
| limit | number | תוצאות לעמוד (ברירת מחדל: 20, מקסימום: 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",
"imageTransparent": "https://img.fraganty.ai/perfume-nobg/64818.webp",
"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/:slugקבל פרטי בושם מלאים כולל תווי ריח, אקורדים, דירוגים, עונות ובשמים דומים
בקשה לדוגמה
תגובה
{
"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": "...",
"image": "https://img.fraganty.ai/perfume/25967.jpg",
"imageTransparent": "https://img.fraganty.ai/perfume-nobg/25967.webp",
"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/brandsרשימת כל המותגים עם מספרי בשמים
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
| q | string | חפש מותגים לפי שם |
בקשה לדוגמה
תגובה
{
"data": [
{ "name": "Guerlain", "slug": "Guerlain", "count": 412 },
{ "name": "Dior", "slug": "Dior", "count": 312 },
{ "name": "Chanel", "slug": "Chanel", "count": 248 }
],
"total": 6619
}/api/notesרשימת כל תווי הריח עם ספירת תדירות
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
| limit | number | הגבל תוצאות (ברירת מחדל: הכל) |
בקשה לדוגמה
תגובה
{
"data": [
{ "name": "Musk", "count": 3097 },
{ "name": "Bergamot", "count": 2498 },
{ "name": "Rose", "count": 2460 }
],
"total": 981
}/api/perfumersרשימת כל הבשמנים עם מספרי בשמים
בקשה לדוגמה
תגובה
{
"data": [
{ "name": "Alberto Morillas", "slug": "alberto-morillas", "count": 45 },
{ "name": "Olivier Polge", "slug": "olivier-polge", "count": 38 }
],
"total": 358
}/api/perfumers/:slugקבל פרטי בשמן עם הבשמים שלו (עם דפדוף)
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
| page | number | מספר עמוד (ברירת מחדל: 1) |
| limit | number | תוצאות לעמוד (ברירת מחדל: 20) |
בקשה לדוגמה
תגובה
{
"name": "Alberto Morillas",
"slug": "alberto-morillas",
"perfumes": {
"data": [...],
"total": 45,
"page": 1,
"pages": 3
}
}/api/perfumes/:slug/similarFind similar perfumes based on accord cosine similarity, note overlap, and curated data
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
| limit | number | Max results (default 10, max 20) |
בקשה לדוגמה
תגובה
{
"source": { "id": "bleu-de-chanel-eau-de-parfum", "name": "Bleu de Chanel EDP", "brand": "Chanel" },
"data": [
{
"id": "sauvage-dior",
"name": "Sauvage",
"brand": "Dior",
"matchScore": 87,
"image": "https://img.fraganty.ai/perfume/12345.jpg",
"imageTransparent": "https://img.fraganty.ai/perfume-nobg/12345.webp",
"sharedAccords": [{ "name": "Woody", "strength": 95, "color": "#6B4226" }],
"sharedNotes": ["bergamot", "cedar"],
"accords": [...]
}
],
"total": 5
}/api/perfumes/:slug/dupesFind cheaper alternatives (dupes) to a luxury/premium perfume. Returns perfumes with matching accord/note profiles at a lower price tier.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
| limit | number | Max results (default 20, max 50) |
בקשה לדוגמה
תגובה
{
"source": {
"id": "bleu-de-chanel-eau-de-parfum",
"name": "Bleu de Chanel EDP",
"brand": "Chanel",
"image": "https://img.fraganty.ai/perfume/25967.jpg",
"imageTransparent": "https://img.fraganty.ai/perfume-nobg/25967.webp",
"rating": 4.21
},
"data": [
{
"id": "oakcha-eastern-bliss",
"name": "Eastern Bliss",
"brand": "Oakcha",
"priceTier": "affordable",
"matchScore": 87,
"rating": 4.35,
"image": "https://img.fraganty.ai/perfume/76543.jpg",
"imageTransparent": "https://img.fraganty.ai/perfume-nobg/76543.webp",
"sharedAccords": [{ "name": "Citrus", "strength": 100, "color": "#DAA520" }],
"sharedNotes": ["bergamot", "cedar"],
"accords": [...]
}
],
"total": 15
}/api/perfumes/matchMatch perfumes by accords, notes, gender, season, and time of day
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
| accords | string | Comma-separated accords with optional strength (e.g. woody:80,amber:60) |
| notes | string | Comma-separated note names (e.g. bergamot,cedar) |
| gender | string | Filter by gender: masculine, feminine, unisex |
| season | string | Filter by best season: winter, spring, summer, fall |
| time | string | Filter by best time: day, night |
| page | number | מספר עמוד (ברירת מחדל: 1) |
| limit | number | Results per page (default 20, max 50) |
בקשה לדוגמה
תגובה
{
"data": [
{
"id": "tobacco-vanille",
"name": "Tobacco Vanille",
"brand": "Tom Ford",
"matchScore": 92,
"rating": 4.31,
"accords": [...]
}
],
"filters": { "accords": ["woody:80", "amber"], "notes": ["bergamot"], "season": "winter" },
"total": 145,
"page": 1,
"pages": 8
}/api/accordsList all fragrance accords with perfume counts and colors
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
| search | string | Filter accords by name |
| limit | number | Max results (default 50, max 100) |
בקשה לדוגמה
תגובה
{
"data": [
{ "name": "Woody", "count": 42350, "color": "#6B4226" },
{ "name": "Warm Spicy", "count": 18200, "color": "#A0522D" }
],
"total": 3
}