find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/scento:scento-search-the-compendium-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Scento Compendium Search the Compendium API
  version: 1.0.0
  summary: 'Scento Perfume Compendium: the perfume knowledge connector for AI assistants, over plain HTTP.'
  description: 'Scento Perfume Compendium is the perfume knowledge connector for AI assistants: 700+ designer and niche perfumes, 400+ raw materials and Scento''s own family system, with every answer tied to a page on scento.com. 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.'
  termsOfService: https://www.scento.com/terms-of-service
  contact:
    name: Scento
    url: https://www.scento.com/developers
    email: support@scento.com
  license:
    name: Scento terms of service
    url: https://www.scento.com/terms-of-service
servers:
- url: https://www.scento.com/api/compendium/v1
security: []
tags:
- name: Search the Compendium
paths:
  /search:
    get:
      operationId: searchCompendium
      summary: Search the Compendium
      description: Find perfumes, houses and raw materials in the Scento Compendium by name, house, note or mood word. Same answer as the MCP tool `compendium-search`.
      tags:
      - Search the Compendium
      parameters:
      - name: q
        in: query
        required: true
        description: Name, house, note or mood word.
        schema:
          type: string
      - name: kind
        in: query
        required: false
        description: Limit to one kind.
        schema:
          type: string
          enum:
          - perfume
          - house
          - material
          - any
          default: any
      - name: lang
        in: query
        required: false
        description: Language of the scento.com links and labels. Answers stay in English.
        schema:
          type: string
          enum:
          - en
          - de
          - fr
          - es
          - it
          - ro
          - el
          - hu
          - cs
          - pl
          default: en
      - name: continuation
        in: query
        required: false
        description: Opaque value from a previous answer, to fetch the next part of a list.
        schema:
          type: string
      responses:
        '200':
          description: A folio answer.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Folio'
        '400':
          description: The input could not be used.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /perfumes:
    get:
      operationId: searchPerfumes
      summary: Search the Compendium
      description: Find perfumes, houses and raw materials in the Scento Compendium by name, house, note or mood word. Perfumes only. Same answer as the MCP tool `compendium-search`.
      tags:
      - Search the Compendium
      parameters:
      - name: q
        in: query
        required: true
        description: Perfume or house name, note or mood word.
        schema:
          type: string
      - name: lang
        in: query
        required: false
        description: Language of the scento.com links and labels. Answers stay in English.
        schema:
          type: string
          enum:
          - en
          - de
          - fr
          - es
          - it
          - ro
          - el
          - hu
          - cs
          - pl
          default: en
      - name: continuation
        in: query
        required: false
        description: Opaque value from a previous answer, to fetch the next part of a list.
        schema:
          type: string
      responses:
        '200':
          description: A folio answer.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Folio'
        '400':
          description: The input could not be used.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      type: object
      description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
      x-ae-placeholder: true
    Folio:
      type: object
      description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
      x-ae-placeholder: true
externalDocs:
  description: Scento Perfume Compendium for developers
  url: https://www.scento.com/developers