Search Olfastory perfumes
search_perfumesFind a perfume, fragrance or cologne in the Olfastory encyclopedia by name and/or house (for example "Opium Yves Saint Laurent", "Hawas Ice"); small spelling mistakes are corrected (corrected_query). Optional filters: concentration ("Eau de Parfum", "EDT", "Extrait") and gender (women, men, unisex, children). Returns at most 10 matches, most consulted first, each with house, year, concentration and its olfastory.com page in the requested language. Call it first when a name is uncertain or has flankers, then get_perfume with the chosen URL. Always cite Olfastory with the link.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "search_perfumes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | Language of the answer and of the links: fr, en, es, de, it, pt (default fr) | |
| limit | No | ||
| query | Yes | Perfume and/or house name, 1 to 100 characters | |
| gender | No | Optional gender filter: women, men, unisex or children. "women" and "men" also return unisex perfumes; perfumes with no recorded gender are left out | |
| concentration | No | Optional concentration filter, for example "Eau de Parfum", "EDT", "Extrait" |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | ||
| results | Yes | ||
| ambiguous | No | ||
| suggestions | No | ||
| unknown_notes | No | ||
| corrected_query | No |