Scento Perfume API docs
The Scento Perfume API is a free, read-only API about perfumes. Ask it for a perfume and you get its top, heart and base notes, its scent family and when it is worn. Ask it for a note and you get what the material smells like and which perfumes show it. It also finds similar perfumes, compares up to four side by side, profiles perfume houses, suggests perfumes for an occasion and searches the Scento journal.
It needs no API key and no account. Every answer links to the matching page on scento.com, and the same answers are available over plain HTTP and as a remote MCP server for AI assistants.
These pages are a developer guide written around the official reference at www.scento.com/developers, which stays the canonical source.
Where to start
- Getting started: the base URL and a first request in curl, JavaScript and Python.
- Reading an answer: the shape every response shares, languages, paging and errors.
- Endpoints: every route with its parameters, a request and a live response.
- MCP server: connect Claude, ChatGPT, Cursor, VS Code and Claude Code to one URL.
- Integrations: the n8n node, the stdio packages and the other places the API is listed.
- Limits and terms: what is allowed, what is asked of you and how to credit an answer.
At a glance
| Item | Value |
|---|---|
| REST base URL | https://www.scento.com/api/perfume/v1 |
| MCP endpoint | https://www.scento.com/mcp (streamable HTTP) |
| OpenAPI 3.1 | openapi.json |
| Authentication | None |
| Method and format | GET, JSON |
| Browser calls | Open CORS |
| Languages | Answers in English; lang switches the language of scento.com links |
| Scope | Perfumes, raw materials, houses, families, occasions, journal. No prices, stock or reviews |
Questions or problems: www.scento.com/developers lists the contact address.