Scento Perfume API
Free perfume and fragrance API and MCP server for AI assistants, built on Scento's verified perfume database: notes, scent families, similar perfumes, raw…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Free perfume and fragrance API and MCP server for AI assistants, built on Scento's verified perfume database: notes, scent families, similar perfumes, raw materials and houses, each answer linked to a page on scento.com. Covers 1,600+ designer and niche perfumes, 400+ raw materials and 160+ perfume houses. No key, no account.
The same twelve read-only answers as the MCP server at https://www.scento.com/mcp. Every answer is a folio: a quotable lede, a detail object, the scento.com page to read on, further reading and a cite line. Lists return an opaque continuation value. Comma-separated values are accepted wherever a list is expected.
Endpoints 14
Search perfumes, houses and notes
- GETSearch perfumes, houses and notes
/search?q=stringUse this when the user asks to find a perfume, fragrance, cologne or scent by name, house, note or mood, or when a name is uncertain (synonyms: perfume,… - GETSearch perfumes, houses and notes
/perfumes?q=stringUse this when the user asks to find a perfume, fragrance, cologne or scent by name, house, note or mood, or when a name is uncertain (synonyms: perfume,…
Get a perfume's notes and profile
- GETGet a perfume's notes and profile
/perfumes/:perfumeUse this when the user asks what a specific perfume, fragrance or cologne smells like, what its notes or pyramid (top, heart, base) are, its family, perfumer,…
Find similar perfumes
- GETFind similar perfumes
/perfumes/:perfume/neighboursUse this when the user asks for perfumes similar to, like or in the same style as a given perfume, fragrance or cologne, or what else to try if they love it…
Compare perfumes side by side
- GETCompare perfumes side by side
/contrast?perfumes=stringUse this when the user asks to compare, contrast or choose between two to four named perfumes, fragrances or colognes (synonyms: versus, vs, difference…
Explain a note or ingredient
- GETExplain a note or ingredient
/materials/:materialUse this when the user asks what a note or raw material smells like or is (for example vetiver, oud, vanilla, iris, ambroxan, bergamot), whether it is natural…
Find perfumes by note
- GETFind perfumes by note
/materials/match?materials=stringUse this when the user wants perfumes, fragrances or colognes that contain specific notes or raw materials, optionally in the top, heart or base (synonyms:…
Profile a perfume house
- GETProfile a perfume house
/houses/:houseUse this when the user asks about a perfume house, brand or maison (for example Creed, Le Labo, Amouage): where it is from, when it was founded, its style and…
Explore fragrance families
- GETExplore fragrance families
/familiesUse this when the user asks how fragrances are grouped or what a scent family is (for example woody, floral, amber, fresh, citrus), or wants the exemplar… - GETExplore fragrance families
/families/:familyUse this when the user asks how fragrances are grouped or what a scent family is (for example woody, floral, amber, fresh, citrus), or wants the exemplar…
Pick perfumes for an occasion
- GETPick perfumes for an occasion
/edits/:occasionUse this when the user asks which perfume, fragrance or cologne to wear for one occasion, season or climate: wedding, office, date night, night out, weekend,…
Build a fragrance wardrobe
- GETBuild a fragrance wardrobe
/wardrobe?loves=stringUse this when the user wants a small fragrance wardrobe or collection (three to five perfumes for different moments) built around perfumes or notes they…
Explain a perfumery term
- GETExplain a perfumery term
/lexicon/:termUse this when the user asks what a perfume or fragrance term means: sillage, projection, longevity, drydown, top, heart and base notes, accord, chypre,…
Search the Scento journal
- GETSearch the Scento journal
/journal?q=stringUse this when the user wants articles, guides or background reading on a perfume, fragrance, cologne, house, note or topic (for example layering, vetiver, how…
API details
- Base URL
https://www.scento.com/api/perfume/v1- Authentication
- None declared in the description
- Operations
- 14 operations on 14 pathsGET 14
- Main resources
- Explore fragrance families 2Search perfumes, houses and notes 2Build a fragrance wardrobe 1Compare perfumes side by side 1Explain a note or ingredient 1Explain a perfumery term 1Find perfumes by note 1Find similar perfumes 1Get a perfume's notes and profile 1Pick perfumes for an occasion 1
- Response formats
application/json- Description format
- OpenAPI 3.1.0, API version
1.0.0 - Links
- Documentation · OpenAPI document · Terms of service · Support
- Listed from
- Scento's published OpenAPI description
How to test the Scento Perfume API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Scento Perfume API collection, without the publisher's secrets.
- Add your credentialsOpen the collection's variables or an environment and enter your API key or token, if the API needs one.
- Send a requestPick an endpoint, for example “Search perfumes, houses and notes” (GET /search?q=string), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Scento Perfume API?
Free perfume and fragrance API and MCP server for AI assistants, built on Scento's verified perfume database: notes, scent families, similar perfumes, raw… It is listed under Data & analytics and has 14 endpoints.
Who publishes the Scento Perfume API?
It is listed from Scento's public API description (an OpenAPI document), not published by Scento on Swastik Codes. Anyone who controls scento.com can claim the profile by adding a DNS TXT record.
What is the base URL of the Scento Perfume API?
Requests go to https://www.scento.com/api/perfume/v1. Endpoint paths are added to this base URL.
How do I authenticate with the Scento Perfume API?
Its OpenAPI description does not declare an authentication scheme. Some endpoints may be open; check the provider's documentation before relying on that.
How many endpoints does the Scento Perfume API have?
14 operations on 14 paths (14 GET). The largest groups are Explore fragrance families, Search perfumes, houses and notes, Build a fragrance wardrobe, Compare perfumes side by side.
Is forking the Scento Perfume API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.