OurScent API documentation
Everything you need to call perfume recognition and the perfume database: keys, errors, limits, billing and every endpoint.
https://api.ourscent.online/v1- Getting startedCreate a business account, take a test key, and identify your first perfume from a photo with the OurScent API.
- Authentication and keysTest and live keys, scopes, IP allowlists, allowed origins and key rotation in the OurScent API.
- ErrorsThe error format and HTTP codes of the OurScent API, and what to do about each.
- Rate limitsHow many requests per second each OurScent API plan allows, and how to read the limit headers.
- Billing and creditsThe monthly subscription, included allowance, rollover, 12-month top-ups and the 402 error in the OurScent API.
- VisionPOST /v1/vision/identify: send a bottle photo and get the exact perfume and its five closest candidates. Parameters, response and best practice.
- Perfume dataPerfume database endpoints: search in Arabic and English, the full record, notes, accords, performance, similar perfumes, prices and images.
- MCP server for AI agentsConnect Claude, Claude Code, Cursor and ChatGPT to the OurScent MCP server to identify perfumes and read their records.
- SDKs, OpenAPI and PostmanCall the OurScent API from Python, JavaScript and PHP, or generate your own client from the OpenAPI file.
- WebhooksComing soonNotifications when the catalogue changes, a new model version ships, or your balance runs low. Coming soon.
- Store appsComing soonOurScent apps for Shopify, WooCommerce, Salla and Zid stores: fill a product page from a photo. Coming soon.
Your first key in two minutes
Sign in with your OurScent account, create a test key, send your first call.