addedInput schema / properties / accords
Added value: +{
+ "description": "Known accords of the starting perfume. Example: [\"amber\",\"woody\",\"sweet\"]",
+ "items": {
+ "maxLength": 40,
+ "type": "string"
+ },
+ "maxItems": 6,
+ "type": "array"
+}
addedInput schema / properties / cursor
Added value: +{
+ "description": "Opaque cursor from a previous result's next_cursor, to fetch the next page. Omit for the first page.",
+ "maxLength": 64,
+ "type": "string"
+}
changedInput schema / properties / gender / description
Previous value: -"Only return perfumes for this audience (men/women include unisex)"New value: +"Only return perfumes for this audience (men and women include unisex)"
changedInput schema / properties / house / description
Previous value: -"House of the perfume, e.g. \"Maison Francis Kurkdjian\""New value: +"House of the perfume when the name alone is ambiguous, e.g. \"Maison Francis Kurkdjian\""
removedInput schema / properties / id
Removed value: -{
- "description": "Fragrance Index id of the perfume to match",
- "maxLength": 120,
- "type": "string"
-}
addedInput schema / properties / limit / default
Added value: +8
changedInput schema / properties / limit / description
Previous value: -"How many results to return (1-10, default 8)."New value: +"How many results per page (1-15, default 8)."
changedInput schema / properties / limit / maximum
Previous value: -10New value: +15
addedInput schema / properties / locale
Added value: +{
+ "default": "en",
+ "description": "Language of the 10ml.com links and fixed labels: en, de, fr, es, it, ro, el, hu, cs or pl. Perfume, house and note names are never translated.",
+ "enum": [
+ "en",
+ "de",
+ "fr",
+ "es",
+ "it",
+ "ro",
+ "el",
+ "hu",
+ "cs",
+ "pl"
+ ],
+ "type": "string"
+}
removedInput schema / properties / name
Removed value: -{
- "description": "Name of the perfume, e.g. \"Baccarat Rouge 540\"",
- "maxLength": 120,
- "type": "string"
-}
changedInput schema / properties / notes / description
Previous value: -"Known notes of the perfume (use when it is not in the index), e.g. [\"jasmine\",\"saffron\",\"ambergris\",\"cedar\"]"New value: +"Known notes of the starting perfume, for perfumes outside the index. Example: [\"jasmine\",\"saffron\",\"ambergris\",\"cedar\"]"
changedInput schema / properties / notes / maxItems
Previous value: -40New value: +30
addedInput schema / properties / other_houses_only
Added value: +{
+ "default": false,
+ "description": "True to leave out perfumes from the same house as the starting perfume",
+ "type": "boolean"
+}
addedInput schema / properties / perfume
Added value: +{
+ "description": "A perfume by name, optionally with its house, e.g. \"Baccarat Rouge 540\", \"Dior Sauvage\", \"Delina\". Or pass an id from another tool.",
+ "maxLength": 120,
+ "type": "string"
+}
addedInput schema / properties / response_format
Added value: +{
+ "default": "concise",
+ "description": "concise (default): the essentials, about a third of the size. detailed: adds the full note pyramid, seasons, occasions, longevity and projection.",
+ "enum": [
+ "concise",
+ "detailed"
+ ],
+ "type": "string"
+}
addedInput schema / properties / steer
Added value: +{
+ "description": "Move away from the starting point in one direction: fresher, sweeter, darker, lighter, longer_lasting (needs a perfume in the index) or more_projection (same).",
+ "enum": [
+ "fresher",
+ "sweeter",
+ "darker",
+ "lighter",
+ "longer_lasting",
+ "more_projection"
+ ],
+ "type": "string"
+}
addedOutput schema / properties / message / description
Added value: +"Guidance when the result is empty, partial or needs a follow-up tool"
addedOutput schema / properties / next_cursor
Added value: +{
+ "description": "Pass as cursor to get the next page; absent on the last page",
+ "type": "string"
+}
removedOutput schema / properties / results / items / properties / accords
Removed value: -{
- "description": "Main accords, strongest first",
- "items": {
- "type": "string"
- },
- "type": "array"
-}
removedOutput schema / properties / results / items / properties / character
Removed value: -{
- "description": "One-sentence editorial description by 10ML's fragrance editors",
- "type": "string"
-}
addedOutput schema / properties / results / items / properties / closeness
Added value: +{
+ "enum": [
+ "very close",
+ "similar vibe",
+ "same spirit"
+ ],
+ "type": "string"
+}
removedOutput schema / properties / results / items / properties / family
Removed value: -{
- "description": "Fragrance family",
- "type": "string"
-}
removedOutput schema / properties / results / items / properties / gender
Removed value: -{
- "enum": [
- "men",
- "women",
- "unisex"
- ],
- "type": "string"
-}
removedOutput schema / properties / results / items / properties / guideUrl
Removed value: -{
- "description": "A 10ML guide about this perfume",
- "type": "string"
-}
removedOutput schema / properties / results / items / properties / house
Removed value: -{
- "type": "string"
-}
removedOutput schema / properties / results / items / properties / houseUrl
Removed value: -{
- "description": "The house page on 10ml.com",
- "type": "string"
-}
removedOutput schema / properties / results / items / properties / id
Removed value: -{
- "description": "Stable Fragrance Index identifier, usable with get_perfume and find_similar_perfumes",
- "type": "string"
-}
removedOutput schema / properties / results / items / properties / keyNotes
Removed value: -{
- "description": "The defining notes",
- "items": {
- "type": "string"
- },
- "type": "array"
-}
removedOutput schema / properties / results / items / properties / name
Removed value: -{
- "type": "string"
-}
addedOutput schema / properties / results / items / properties / perfume
Added value: +{
+ "additionalProperties": false,
+ "properties": {
+ "accords": {
+ "description": "Main accords, strongest first",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "character": {
+ "description": "One-sentence description by 10ML's fragrance editors",
+ "type": "string"
+ },
+ "concentration": {
+ "type": "string"
+ },
+ "family": {
+ "description": "Fragrance family, e.g. \"amber floral\"",
+ "type": "string"
+ },
+ "gender": {
+ "enum": [
+ "men",
+ "women",
+ "unisex"
+ ],
+ "type": "string"
+ },
+ "house": {
+ "type": "string"
+ },
+ "id": {
+ "description": "Stable Fragrance Index id, usable with get_perfume and find_similar_perfumes",
+ "type": "string"
+ },
+ "key_notes": {
+ "description": "The defining notes (empty when no pyramid is published)",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "links": {
+ "description": "1-3 relevant 10ml.com links",
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "title": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "try",
+ "guide",
+ "note"
+ ],
+ "type": "string"
+ },
+ "url": {
+ "description": "A 10ml.com link in the requested locale",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "title",
+ "url"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "longevity": {
+ "description": "1 (short) to 5 (very long)",
+ "type": "number"
+ },
+ "name": {
+ "type": "string"
+ },
+ "occasions": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "other_versions": {
+ "description": "Ids of other concentrations or flankers of the same perfume in the index",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "perfumers": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "projection": {
+ "description": "1 (skin scent) to 5 (fills a room)",
+ "type": "number"
+ },
+ "pyramid": {
+ "additionalProperties": false,
+ "properties": {
+ "base": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "heart": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "top": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "top",
+ "heart",
+ "base"
+ ],
+ "type": "object"
+ },
+ "seasons": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "styles": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "year": {
+ "description": "Launch year when known",
+ "type": "number"
+ }
+ },
+ "required": [
+ "id",
+ "name",
+ "house",
+ "gender",
+ "family",
+ "accords",
+ "key_notes",
+ "character",
+ "links"
+ ],
+ "type": "object"
+}
removedOutput schema / properties / results / items / properties / sharedAccords
Removed value: -{
- "items": {
- "type": "string"
- },
- "type": "array"
-}
removedOutput schema / properties / results / items / properties / sharedNotes
Removed value: -{
- "items": {
- "type": "string"
- },
- "type": "array"
-}
addedOutput schema / properties / results / items / properties / shared_accords
Added value: +{
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+}
addedOutput schema / properties / results / items / properties / shared_notes
Added value: +{
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+}
removedOutput schema / properties / results / items / properties / url
Removed value: -{
- "description": "\"Try it at 10ML\": find this perfume on 10ml.com",
- "type": "string"
-}
addedOutput schema / properties / results / items / properties / why
Added value: +{
+ "type": "string"
+}
removedOutput schema / properties / results / items / properties / year
Removed value: -{
- "description": "Launch year",
- "type": "number"
-}
changedOutput schema / properties / results / items / required
Previous value: -[
- "id",
- "name",
- "house",
- "gender",
- "family",
- "accords",
- "keyNotes",
- "character",
- "url",
- "sharedNotes",
- "sharedAccords"
-]New value: +[
+ "perfume",
+ "closeness",
+ "shared_notes",
+ "shared_accords",
+ "why"
+]
addedOutput schema / properties / source
Added value: +{
+ "type": "string"
+}
addedOutput schema / properties / target / properties / accords
Added value: +{
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+}
removedOutput schema / properties / target / properties / inIndex
Removed value: -{
- "type": "boolean"
-}
addedOutput schema / properties / target / properties / in_index
Added value: +{
+ "type": "boolean"
+}
removedOutput schema / properties / target / properties / url
Removed value: -{
- "type": "string"
-}
changedOutput schema / properties / target / required
Previous value: -[
- "name",
- "house",
- "inIndex",
- "notes"
-]New value: +[
+ "name",
+ "house",
+ "in_index",
+ "notes",
+ "accords"
+]
addedOutput schema / properties / total
Added value: +{
+ "description": "How many results matched in all",
+ "type": "number"
+}
addedOutput schema / properties / unrecognised_notes
Added value: +{
+ "description": "Notes that are not in the index vocabulary and were ignored",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+}
changedOutput schema / required
Previous value: -[
- "target",
- "results"
-]New value: +[
+ "total",
+ "target",
+ "results",
+ "source"
+]
