Scento Perfume API: Free Perfume Notes & Fragrance Database

Scento Perfume API: free perfume notes and fragrance ingredients database

Looking for a free perfume API that works with AI assistants? Scento Perfume API is a fragrance API and perfume MCP server over Scento's verified perfume database: 1,500+ perfumes, 160+ houses, 400+ raw materials, every notes pyramid traced to the house or an authorized retailer.

What you get: a perfume notes database you can query by name, note, family or occasion; a fragrance ingredients database (400+ raw materials with the perfumes that use them); similar-scent and head-to-head comparison endpoints; scent family maps; occasion edits and wardrobe building; a perfumery lexicon; and a journal search for editorial context. Twelve tools in total: perfume-search, perfume-portrait, scent-neighbours, perfume-contrast, note-portrait, material-match, house-portrait, family-map, occasion-edit, wardrobe-composer, perfumery-lexicon, journal-search.

Use it two ways. As an MCP server (remote, streamable HTTP) at https://www.scento.com/mcp, or via npx -y scento-perfume-api and uvx scento-perfume-api for stdio clients. Or as plain REST at https://www.scento.com/api/perfume/v1 with an OpenAPI document at /openapi.json. Both are free and need no API key.

Typical uses: a chatbot that recommends perfumes with real notes, a fragrance finder, a "smells like" lookup, a retailer enriching product pages with a notes pyramid, a student project, or an AI agent that needs a trustworthy perfume database API instead of guessing. Responses come in 10 languages.

Maintained by Scento. Docs and live examples: https://www.scento.com/developers

Ask Scento Perfume API, built on Scento's verified perfume database, from Apify. Search 1,500+ designer and niche perfumes, draw a perfume's portrait with its top, heart and base notes, set two scents side by side, look up 400+ raw materials and 160+ houses, or compose a small fragrance wardrobe. Every answer carries a citable page on scento.com. No API key, no account on our side.

Scento is Europe's largest perfume decant website, founded in Paris in 2024. Scento Perfume API is how we share what we know about fragrance notes with people and their assistants.

What you get

Each run returns dataset rows. A search returns one row per match (kind, name, house, family and the scento.com page). Every other tool returns one row holding the full answer: a quotable lede, a detail object, the page to read on, further reading and a cite line. The complete answer is also stored under the OUTPUT key.

Input

Quick search:

{ "query": "oud" }

Any of the twelve tools:

{ "tool": "perfume-portrait", "arguments": { "perfume": "Delina" } }

{ "tool": "perfume-contrast", "arguments": { "perfumes": ["Eau Sauvage", "Oud Wood"] } }

Tool	What it answers
perfume-search	Search perfumes, materials and houses
perfume-portrait	Family, note pyramid, character and when it wears best
scent-neighbours	Perfumes that share a structure with one you name
perfume-contrast	Two or three perfumes side by side
note-portrait	A raw material: smell, origin, pairings
material-match	Perfumes built on the materials you list
house-portrait	A perfume house and its signatures
family-map / occasion-edit / wardrobe-composer	Scento's family system, an edit for an occasion, a small wardrobe
perfumery-lexicon / journal-search	A perfumery term, or the Scento journal

Argument names for every tool are listed in the developer docs.

Use it from an AI assistant

Any public Actor can be called by MCP clients through Apify's MCP server at https://mcp.apify.com. Add scento/scento-perfume-compendium to its tools and your assistant can look up perfumes and notes mid-conversation. For a direct connection with all twelve tools and no run costs, use Scento's own MCP server below.

Other ways in

• REST API: https://www.scento.com/api/perfume/v1 (OpenAPI 3.1: https://www.scento.com/api/perfume/v1/openapi.json)
• MCP server for Claude, ChatGPT, Cursor and VS Code: https://www.scento.com/mcp
• Developer docs: https://www.scento.com/developers/perfume-api (REST) and https://www.scento.com/developers/perfume-mcp-server (MCP)
• Source: https://github.com/Scento-com/perfume-mcp-server

Please keep requests polite: this is a free service run by a small team.