OurScent

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.jpg
JSON
{
  "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_…"

Your first key in two minutes

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