Perfume data
Perfume database endpoints: search in Arabic and English, the full record, notes, accords, performance, similar perfumes, prices and images.
Search
Understands Arabic spellings and Latin transliteration: “خمرة” and “khamrah” find the same perfume.
curl "https://api.ourscent.online/v1/perfumes/search?q=khamrah&lang=ar" \
-H "Authorization: Bearer os_live_…"The full record
curl "https://api.ourscent.online/v1/perfumes/{id}?lang=fr" \
-H "Authorization: Bearer os_live_…"All endpoints
| Endpoint | Returns |
|---|---|
GET /v1/perfumes | A list with filters: brand, gender, note, accord, perfumer, year, concentration, oud, alcohol_free |
GET /v1/perfumes/search?q= | Name search |
GET /v1/perfumes/{id} | The full record |
GET /v1/perfumes/{id}/notes | Pyramid: top, heart, base |
GET /v1/perfumes/{id}/accords | Ranked accords |
GET /v1/perfumes/{id}/performance | Longevity, sillage, season — an estimate |
GET /v1/perfumes/{id}/similar | Similar perfumes |
GET /v1/perfumes/{id}/dupes | Alternatives |
GET /v1/perfumes/{id}/prices?market=SA | Shop offers and lowest price |
GET /v1/perfumes/{id}/images | Available images and sizes |
GET /v1/brands · /v1/perfumers · /v1/notes · /v1/accords | The dictionaries |
Images
images.bottle lists original, w400 and w800 URLs; images.cutout is a transparent cut-out; images.card is a share card. 0.05 credit per set.
Performance is an estimate
Performance values are computed from accords and concentration and carry kind: "estimate" and a basis. Present them as estimates.