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: -"Who the perfume is marketed for. men/women also include unisex perfumes."New value: +"Audience the perfume is marketed to. men and women also include unisex perfumes."
addedInput schema / properties / limit / default
Added value: +8
changedInput schema / properties / limit / description
Previous value: -"How many results to return (1-20, default 8)."New value: +"How many results per page (1-20, default 8)."
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"
+}
changedInput schema / properties / note / description
Previous value: -"The note, e.g. \"oud\", \"vanilla\", \"pink pepper\""New value: +"The note. Examples: \"oud\", \"vanilla\", \"pink pepper\", \"Vanille\""
addedInput schema / properties / occasion
Added value: +{
+ "description": "Occasion the perfume suits: daytime, office, casual, evening, date night or special occasion.",
+ "enum": [
+ "daytime",
+ "office",
+ "casual",
+ "evening",
+ "date night",
+ "special occasion"
+ ],
+ "type": "string"
+}
addedInput schema / properties / position
Added value: +{
+ "default": "any",
+ "description": "Where the note sits in the pyramid: top, heart, base or any",
+ "enum": [
+ "any",
+ "top",
+ "heart",
+ "base"
+ ],
+ "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 / season
Added value: +{
+ "description": "Season the perfume suits (fall is accepted in text queries as autumn).",
+ "enum": [
+ "spring",
+ "summer",
+ "autumn",
+ "winter"
+ ],
+ "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"
+}
addedOutput schema / properties / note / additionalProperties
Added value: +false
addedOutput schema / properties / note / properties
Added value: +{
+ "family": {
+ "type": "string"
+ },
+ "id": {
+ "type": "string"
+ },
+ "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"
+ },
+ "name": {
+ "type": "string"
+ },
+ "smells_like": {
+ "type": "string"
+ }
+}
addedOutput schema / properties / note / required
Added value: +[
+ "name",
+ "links"
+]
changedOutput schema / properties / note / type
Previous value: -"string"New value: +"object"
removedOutput schema / properties / profile
Removed value: -{
- "additionalProperties": false,
- "properties": {
- "aliases": {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "description": {
- "type": "string"
- },
- "family": {
- "type": "string"
- },
- "guides": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "title": {
- "type": "string"
- },
- "url": {
- "type": "string"
- }
- },
- "required": [
- "title",
- "url"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "name": {
- "type": "string"
- },
- "url": {
- "type": "string"
- }
- },
- "required": [
- "name",
- "family",
- "description",
- "aliases",
- "guides"
- ],
- "type": "object"
-}
changedOutput schema / properties / results / items / properties / character / description
Previous value: -"One-sentence editorial description by 10ML's fragrance editors"New value: +"One-sentence description by 10ML's fragrance editors"
addedOutput schema / properties / results / items / properties / concentration
Added value: +{
+ "type": "string"
+}
changedOutput schema / properties / results / items / properties / family / description
Previous value: -"Fragrance family"New value: +"Fragrance family, e.g. \"amber floral\""
removedOutput schema / properties / results / items / properties / guideUrl
Removed value: -{
- "description": "A 10ML guide about this perfume",
- "type": "string"
-}
removedOutput schema / properties / results / items / properties / houseUrl
Removed value: -{
- "description": "The house page on 10ml.com",
- "type": "string"
-}
changedOutput schema / properties / results / items / properties / id / description
Previous value: -"Stable Fragrance Index identifier, usable with get_perfume and find_similar_perfumes"New value: +"Stable Fragrance Index id, usable with get_perfume and find_similar_perfumes"
removedOutput schema / properties / results / items / properties / keyNotes
Removed value: -{
- "description": "The defining notes",
- "items": {
- "type": "string"
- },
- "type": "array"
-}
addedOutput schema / properties / results / items / properties / key_notes
Added value: +{
+ "description": "The defining notes (empty when no pyramid is published)",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+}
addedOutput schema / properties / results / items / properties / links
Added value: +{
+ "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"
+}
addedOutput schema / properties / results / items / properties / longevity
Added value: +{
+ "description": "1 (short) to 5 (very long)",
+ "type": "number"
+}
addedOutput schema / properties / results / items / properties / occasions
Added value: +{
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+}
addedOutput schema / properties / results / items / properties / other_versions
Added value: +{
+ "description": "Ids of other concentrations or flankers of the same perfume in the index",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+}
addedOutput schema / properties / results / items / properties / perfumers
Added value: +{
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+}
addedOutput schema / properties / results / items / properties / projection
Added value: +{
+ "description": "1 (skin scent) to 5 (fills a room)",
+ "type": "number"
+}
addedOutput schema / properties / results / items / properties / pyramid
Added value: +{
+ "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"
+}
addedOutput schema / properties / results / items / properties / seasons
Added value: +{
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+}
addedOutput schema / properties / results / items / properties / styles
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"
-}
changedOutput schema / properties / results / items / properties / year / description
Previous value: -"Launch year"New value: +"Launch year when known"
changedOutput schema / properties / results / items / required
Previous value: -[
- "id",
- "name",
- "house",
- "gender",
- "family",
- "accords",
- "keyNotes",
- "character",
- "url"
-]New value: +[
+ "id",
+ "name",
+ "house",
+ "gender",
+ "family",
+ "accords",
+ "key_notes",
+ "character",
+ "links"
+]
addedOutput schema / properties / source
Added value: +{
+ "type": "string"
+}
addedOutput schema / properties / total / description
Added value: +"How many results matched in all"
changedOutput schema / required
Previous value: -[
- "note",
- "total",
- "results"
-]New value: +[
+ "total",
+ "note",
+ "results",
+ "source"
+]
