10ml

10ML Fragrance Index API

Free perfume API and fragrance notes API from the 10ML Fragrance Index: 6,000+ perfumes and 249 houses with note pyramids, accords, families, similar scents,…

Data & analytics#open-data

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 API and fragrance notes API from the 10ML Fragrance Index: 6,000+ perfumes and 249 houses with note pyramids, accords, families, similar scents, alternatives from other houses, notes explained and guides, curated by 10ML's fragrance editors. The same answers as the 10ML Perfume Finder MCP server at https://mcp.10ml.com/mcp. No API key needed, no sign-up, read-only JSON over GET. Optional free API key for tools that need one (for example Zapier): POST https://mcp.10ml.com/api/v1/keys with an optional JSON body {"name", "email"} returns a key; send it as the X-API-Key header or as Authorization: Bearer, and GET https://mcp.10ml.com/api/v1/me checks it. A request without a key works as before; a request with a key that is not valid gets 401. Commercial use is allowed and free, and you may store (cache) the results you fetch. Condition: show a visible credit, "Data: 10ML Fragrance Index", linking to https://10ml.com/perfume-api wherever the data appears. There is no fixed rate limit: keep a polite pace and tell contact@10ml.com before heavy volume.

Endpoints 10

10ML Fragrance Index

  • GETSearch perfumes/api/v1/perfumesSearch the 10ML Fragrance Index for perfumes, colognes and fragrances (eau de parfum, eau de toilette, extrait) by name, house, notes, accords, family,…
  • GETGet one perfume/api/v1/perfumes/:idThe full Fragrance Index profile of one perfume, cologne or fragrance: house, launch year, audience, concentration, family, accords, note pyramid (top, heart…
  • GETFind similar perfumes/api/v1/similarFind perfumes and colognes that smell like one the person already likes, ranked by shared notes, accords and style, each saying exactly what it shares and how…
  • GETFind alternatives to a perfume from other houses/api/v1/alternativesThe editors' alternatives (dupes) to a famous perfume or cologne, from other houses: for each, why it is close and how close (very close, similar vibe, same…
  • GETExplain a note/api/v1/notes/:idExplain a fragrance note or perfume ingredient: what it smells like, its family and mood, where it comes from, which notes it pairs with, similar notes,…
  • GETList perfume houses/api/v1/housesBrowse the perfume houses and fragrance brands in the 10ML Fragrance Index with country, type (designer, niche, middle-eastern, indie, celebrity), perfumes…
  • GETGet one perfume house/api/v1/houses/:idProfile of a perfume house or fragrance brand: country, founded year, style (designer, niche, Middle Eastern, indie), what it is known for, its signature…
  • GETSearch 10ML guides/api/v1/guidesFind 10ML's perfume and fragrance guides to read or cite: how-tos (where to spray, finding a signature scent, making perfume last), notes explained, house…

API keys

  • POSTGet a free API key/api/v1/keysReturns a free API key, no sign-up. The API works without a key; get one only when a tool needs it. The key is shown once and not kept on our side: save it.…
  • GETCheck an API key/api/v1/meTells whether the key sent in the X-API-Key header (or as Authorization: Bearer) is valid. Answers 401 when no key or a key that is not valid is sent.

API details

Base URL
https://mcp.10ml.com
Authentication
An API key in the X-API-Key header
A bearer token in the Authorization header
Operations
10 operations on 10 pathsGET 9POST 1
Main resources
10ML Fragrance Index 8API keys 2
Response formats
application/json
Description format
OpenAPI 3.1.0, API version 2.6.1

How to test the 10ML Fragrance Index API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the 10ML Fragrance Index API collection, without the publisher's secrets.
  3. Add your credentialsThis API uses an API key in the X-API-Key header. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Search perfumes” (GET /api/v1/perfumes), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the 10ML Fragrance Index API?

Free perfume API and fragrance notes API from the 10ML Fragrance Index: 6,000+ perfumes and 249 houses with note pyramids, accords, families, similar scents,… It is listed under Data & analytics and has 10 endpoints.

Who publishes the 10ML Fragrance Index API?

It is listed from 10ml's public API description (an OpenAPI document), not published by 10ml on Swastik Codes. Anyone who controls mcp.10ml.com can claim the profile by adding a DNS TXT record.

What is the base URL of the 10ML Fragrance Index API?

Requests go to https://mcp.10ml.com. Endpoint paths are added to this base URL.

How do I authenticate with the 10ML Fragrance Index API?

It accepts 2 methods: an API key in the X-API-Key header; A bearer token in the Authorization header.

How many endpoints does the 10ML Fragrance Index API have?

10 operations on 10 paths (9 GET, 1 POST). The largest groups are 10ML Fragrance Index, API keys.

Is forking the 10ML Fragrance Index API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.