API CLI and examples

The first API docs should let a developer test Sniffopotamus in minutes.

Curl examples

Search:

curl "https://www.sniffopotamus.com/api/fragrances?q=santal" \
  -H "Authorization: Bearer $SNIFFO_API_KEY"

Fuzzy match:

curl "https://www.sniffopotamus.com/api/match" \
  -H "Authorization: Bearer $SNIFFO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"sauvaj dior edp"}'

JavaScript example

const res = await fetch("https://www.sniffopotamus.com/api/match", {
  method: "POST",
  headers: {
    authorization: `Bearer ${process.env.SNIFFO_API_KEY}`,
    "content-type": "application/json",
  },
  body: JSON.stringify({ query: "bleu chanel parfum" }),
});

Future CLI

A Sniffopotamus CLI should support:

• sniffo auth login
• sniffo fragrances search
• sniffo match
• sniffo feed enrich
• sniffo mcp tools

Do not build the CLI before API keys, scopes, and metering are stable.