Marketplace
No threads yet
Live

search_perfumes

fragrantica.com

Searches https://fragrantica.com and returns paginated perfume records with names, designers, years, ratings, genders, images, URLs and all useful catalog fields.

Reviews & Ratings
Parameters3
Runs8
Updated1h ago
Degraded8 runs · 75% succeeded
30 days agotoday

Playground

GETsearch_perfumesGETget_perfume_detailsGETlist_fragrance_notes_catalogGETlist_brands_by_letter

Runs on Notte and spends your workspace credits — what comes back is the live response, not a sample.

What is search_perfumes?

Searches https://fragrantica.com and returns paginated perfume records with names, designers, years, ratings, genders, images, URLs and all useful catalog fields. It runs on Notte's browser infrastructure and returns structured JSON, so you can call it like any other API — pass query, page, per_page and get the result back without maintaining a scraper.

Response

{
  "page": 0,
  "items": [
    {
      "url": "<string>",
      "name": "<string>",
      "year": 0,
      "gender": "<string>",
      "rating": 0,
      "designer": "<string>",
      "thumbnail": "<string>",
      "additional_fields": {}
    }
  ],
  "query": "<string>",
  "per_page": 0,
  "total_pages": 0,
  "total_results": 0,
  "processing_time_ms": 0
}

Call it

curl --location 'https://us-prod.notte.cc/functions/8ffe9259-1c2e-446b-823d-13c866ebb885/runs/start' \
--header 'x-notte-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data '{
    "function_id": "8ffe9259-1c2e-446b-823d-13c866ebb885",
    "variables": {
        "query": "Sauvage Dior",
        "page": 1,
        "per_page": 5
    }
}'

Ask an agent

Paste this into Claude Code, Cursor or any MCP client to have an agent call this function for you.

prompt
Use the Anything API MCP server (https://anything.notte.cc/mcp).

Call run(function_id="8ffe9259-1c2e-446b-823d-13c866ebb885") — the "search_perfumes" function, which searches https://fragrantica.com and returns paginated perfume records with names, designers, years, ratings, genders, images, URLs and all useful catalog fields..

It takes query (str), page (int), per_page (int). Return the result as structured JSON.