OurScent

Démarrer : votre premier appel en deux minutes

Créez un compte professionnel, prenez une clé de test et identifiez votre premier parfum par photo avec l’API OurScent.

1. Créez un compte

Connectez-vous avec votre compte OurScent, ouvrez la console et saisissez votre société et votre pays. Vous recevez aussitôt l’offre gratuite (200 crédits par mois) et une clé de test.

2. Copiez votre clé

La clé n’est affichée qu’une fois. Les clés os_test_ renvoient gratuitement des données d’exemple fixes ; les clés os_live_ renvoient les vraies données et consomment des crédits.

3. Envoyez une 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. Lisez la fiche du parfum

Prenez le perfume_id du premier candidat et demandez sa fiche, ou ajoutez ?expand=perfume à l’appel d’identification pour recevoir la fiche avec chaque candidat.

curl "https://api.ourscent.online/v1/perfumes/{id}?lang=fr" \
  -H "Authorization: Bearer os_live_…"

Votre première clé en deux minutes

Connectez-vous avec votre compte OurScent, créez une clé de test, envoyez votre premier appel.