OurScent

Perfume data

Perfume database endpoints: search in Arabic and English, the full record, notes, accords, performance, similar perfumes, prices and images.

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

EndpointReturns
GET /v1/perfumesA 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}/notesPyramid: top, heart, base
GET /v1/perfumes/{id}/accordsRanked accords
GET /v1/perfumes/{id}/performanceLongevity, sillage, season — an estimate
GET /v1/perfumes/{id}/similarSimilar perfumes
GET /v1/perfumes/{id}/dupesAlternatives
GET /v1/perfumes/{id}/prices?market=SAShop offers and lowest price
GET /v1/perfumes/{id}/imagesAvailable images and sizes
GET /v1/brands · /v1/perfumers · /v1/notes · /v1/accordsThe 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.

Your first key in two minutes

Sign in with your OurScent account, create a test key, send your first call.