OurScent

Perfume intelligence API

Recognize a perfume from a photo, and read the whole perfume record in Arabic, English and French — notes, accords, performance, houses, perfumers and prices — in one call.

Try it with a photo

Snap a bottle or upload a photo. No sign-up — three tries a day.

Drop a bottle photo here

Your photo is deleted within 24 hours.

perfumes on record
60,000+
perfumes the model names from a photo
2,017
right answer in the top 3
93.2%
houses
3,268
languages in every record
3

Three APIs, one record

One request, in any language

Your key in the Authorization header, the photo in the body. That is all.

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

Example response

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…"
}

Your AI agents can call it directly

A ready MCP server: Claude, Cursor and ChatGPT identify perfumes and read their records without a line of glue code.

MCP setup
Claude Code
claude mcp add --transport http ourscent https://api.ourscent.online/mcp \
  --header "Authorization: Bearer os_live_…"

Start free, pay as you grow

200 free credits every month, no card. One photo = 1 credit, one perfume record = 0.1 credit.

See all pricing

Free

$0

200 credits

Starter

$15

2,000 credits

Shop

$39

10,000 credits

Business

$129

50,000 credits

Enterprise

Custom

Dedicated

Questions developers ask

What makes this perfume recognition API different?

It names the exact perfume out of 2,017, not just the brand, and its accuracy is published: 77.6% first pick and 93.2% in the top 3 on 9,047 test photos it never saw in training. Every answer comes with the full perfume record in three languages.

Is there a free plan?

Yes: 200 credits every month with no card — enough for 200 photos or 2,000 perfume records. Test keys (os_test_) are always free and return fixed sample data.

Which languages does the data come in?

Arabic, English and French: perfume names, notes, accords and descriptions. Search understands Arabic spelling variants and Latin transliterations of Arabic names.

What happens to the photos I send?

They are deleted within 24 hours and never leave our servers, unless you explicitly opt in to them improving the model.

Can we run the model on our own servers?

Yes, on the Enterprise plan: a Docker image with the model and its index, under a yearly licence with every release included.

Your first key in two minutes

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