Getting started: your first call in two minutes
Create a business account, take a test key, and identify your first perfume from a photo with the OurScent API.
1. Create an account
Sign in with your OurScent account, open the console, and enter your company and country. You get the free plan (200 credits a month) and a test key at once.
2. Copy your key
The key is shown once only. os_test_ keys return fixed sample data for free; os_live_ keys return real data and spend credits.
3. Send a photo
curl -X POST "https://api.ourscent.online/v1/vision/identify?k=5" \
-H "Authorization: Bearer os_live_…" \
-H "Content-Type: image/jpeg" \
--data-binary @bottle.jpgJSON
{
"model": "c-20261122",
"candidates": [
{
"perfume_id": "Khamrah-Lattafa-Perfumes-Lattafa-Perfumes",
"score": 0.91,
"name": "Khamrah",
"name_ar": "خمرة",
"brand": { "id": "lattafa", "name": "Lattafa", "name_ar": "لطافة" },
"thumbnail_url": "https://ourscent.online/perfume-images/…/w400.webp"
},
{ "perfume_id": "Khamrah-Qahwa-Lattafa-Perfumes-Lattafa-Perfumes", "score": 0.06, "…": "…" }
],
"request_id": "req_8f2c…"
}4. Read the perfume’s record
Take the first candidate’s perfume_id and request its record, or add ?expand=perfume to the identify call to get the record with every candidate.
curl "https://api.ourscent.online/v1/perfumes/{id}?lang=fr" \
-H "Authorization: Bearer os_live_…"