Added value: +{
+  "description": "true = only the editors' iconic, era-defining classics (works with every other filter, and without a query)",
+  "type": "boolean"
+}

Removed value: -"The filters applied, including ones read from the query text"

Removed value: -"Guidance when the result is empty, partial or needs a follow-up tool"

Removed value: -"Pass as cursor to get the next page; absent on the last page"

Removed value: -"True when no perfume matched every word and the closest partial matches are shown"

Removed value: -"Main accords, strongest first"

Removed value: -"One-sentence description by 10ML's fragrance editors"

Removed value: -"Fragrance family, e.g. \"amber floral\""

Removed value: -"Stable Fragrance Index id, usable with get_perfume and find_similar_perfumes"

Removed value: -"The defining notes (empty when no pyramid is published)"

Removed value: -"1-3 relevant 10ml.com links"

Removed value: -"A 10ml.com link in the requested locale"

Removed value: -"1 (short) to 5 (very long)"

Removed value: -"Ids of other concentrations or flankers of the same perfume in the index"

Removed value: -"1 (skin scent) to 5 (fills a room)"

Removed value: -"Launch year when known"

Removed value: -"How many results matched in all"

Added value: +{
+  "enum": [
+    "full",
+    "core"
+  ],
+  "type": "string"
+}

Previous value: -[
-  "id",
-  "name",
-  "house",
-  "gender",
-  "family",
-  "accords",
-  "key_notes",
-  "character",
-  "links"
-]New value: +[
+  "id",
+  "name",
+  "house",
+  "gender",
+  "family",
+  "accords",
+  "key_notes",
+  "character",
+  "links",
+  "profile"
+]

Removed value: -"http://json-schema.org/draft-07/schema#"

Previous value: -"Opaque cursor from a previous result's next_cursor, to fetch the next page. Omit for the first page."New value: +"next_cursor from the previous page; omit for the first page."

Previous value: -"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."New value: +"Language of the 10ml.com links and labels. Perfume, house and note names stay as they are."

Previous value: -"concise (default): the essentials, about a third of the size. detailed: adds the full note pyramid, seasons, occasions, longevity and projection."New value: +"concise (default) or detailed (adds note pyramid, seasons, occasions, longevity, projection)."

Removed value: -"http://json-schema.org/draft-07/schema#"

Removed value: -false

Removed value: -false

Removed value: -false

Removed value: -false

Added value: +{
+  "description": "Accords that must be present. Examples: [\"woody\",\"sweet\"], [\"fresh\",\"aquatic\"]",
+  "items": {
+    "maxLength": 40,
+    "type": "string"
+  },
+  "maxItems": 6,
+  "type": "array"
+}

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"
+}

Previous value: -"Restrict to a fragrance family: Citrus, Aquatic, Green, Aromatic Fougère, Floral, Fruity Floral, Floral Amber, Chypre, Woody, Woody Spicy, Amber, Amber Vanilla, Gourmand, Leather, Musky"New value: +"Fragrance family: fougere, chypre, oriental-amber, gourmand, aquatic, aromatic, woody, floral, white-floral, fruity, citrus, green, leather, oud, musky, powdery, spicy, tobacco-boozy, smoky-incense, aldehydic-floral, mineral, fresh-spicy-woody, tea-zen. Also accepts words like \"amber\" or \"citrus\"."

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."

Previous value: -"Restrict to one perfume house, e.g. \"Dior\", \"Maison Francis Kurkdjian\""New value: +"Only perfumes from this house. Examples: \"Dior\", \"Maison Francis Kurkdjian\", \"MFK\", \"YSL\""

Added value: +8

Previous value: -"How many results to return (1-20, default 8)."New value: +"How many results per page (1-20, default 8)."

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"
+}

Removed value: -{
-  "description": "Restrict to perfumes containing a note, e.g. \"oud\", \"tonka bean\", \"bergamot\"",
-  "maxLength": 60,
-  "type": "string"
-}

Added value: +{
+  "description": "None of these notes may be present. Example: [\"patchouli\"]",
+  "items": {
+    "maxLength": 60,
+    "type": "string"
+  },
+  "maxItems": 8,
+  "type": "array"
+}

Added value: +{
+  "description": "Every listed note must be present. Examples: [\"oud\",\"rose\"], [\"vanilla\"]",
+  "items": {
+    "maxLength": 60,
+    "type": "string"
+  },
+  "maxItems": 8,
+  "type": "array"
+}

Added value: +"Occasion the perfume suits: daytime, office, casual, evening, date night or special occasion."

Previous value: -"Free text: perfume name, house, notes, mood. e.g. \"fresh citrus summer for men\", \"oud\", \"vanilla gourmand for winter\""New value: +"Free text: a perfume name, house, notes or mood. Examples: \"fresh citrus summer for men\", \"Tom Ford tobacco\", \"vanilla gourmand for winter\""

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"
+}

Added value: +"Season the perfume suits (fall is accepted in text queries as autumn)."

Added value: +{
+  "description": "A style word: aquatic, boozy, clean, creamy, dark, floral, fresh, citrusy, fruity, gourmand, green, leathery, musky, powdery, sensual, smoky, spicy, sweet, woody.",
+  "enum": [
+    "aquatic",
+    "boozy",
+    "clean",
+    "creamy",
+    "dark",
+    "floral",
+    "fresh",
+    "citrusy",
+    "fruity",
+    "gourmand",
+    "green",
+    "leathery",
+    "musky",
+    "powdery",
+    "sensual",
+    "smoky",
+    "spicy",
+    "sweet",
+    "woody"
+  ],
+  "type": "string"
+}

Previous value: -"The filters that were applied, including ones read from the query"New value: +"The filters applied, including ones read from the query text"

Added value: +"Guidance when the result is empty, partial or needs a follow-up tool"

Added value: +{
+  "description": "Pass as cursor to get the next page; absent on the last page",
+  "type": "string"
+}

Previous value: -"True when no perfume matched every word and partial matches are shown"New value: +"True when no perfume matched every word and the closest partial matches are shown"

Previous value: -"One-sentence editorial description by 10ML's fragrance editors"New value: +"One-sentence description by 10ML's fragrance editors"

Added value: +{
+  "type": "string"
+}

Previous value: -"Fragrance family"New value: +"Fragrance family, e.g. \"amber floral\""

Removed value: -{
-  "description": "A 10ML guide about this perfume",
-  "type": "string"
-}

Removed value: -{
-  "description": "The house page on 10ml.com",
-  "type": "string"
-}

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"

Removed value: -{
-  "description": "The defining notes",
-  "items": {
-    "type": "string"
-  },
-  "type": "array"
-}

Added value: +{
+  "description": "The defining notes (empty when no pyramid is published)",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

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"
+}

Added value: +{
+  "description": "1 (short) to 5 (very long)",
+  "type": "number"
+}

Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Ids of other concentrations or flankers of the same perfume in the index",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "1 (skin scent) to 5 (fills a room)",
+  "type": "number"
+}

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"
+}

Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Removed value: -{
-  "description": "\"Try it at 10ML\": find this perfume on 10ml.com",
-  "type": "string"
-}

Previous value: -"Launch year"New value: +"Launch year when known"

Previous value: -[
-  "id",
-  "name",
-  "house",
-  "gender",
-  "family",
-  "accords",
-  "keyNotes",
-  "character",
-  "url"
-]New value: +[
+  "id",
+  "name",
+  "house",
+  "gender",
+  "family",
+  "accords",
+  "key_notes",
+  "character",
+  "links"
+]

Added value: +{
+  "type": "string"
+}

Previous value: -"How many perfumes matched in all"New value: +"How many results matched in all"

Previous value: -[
-  "total",
-  "results",
-  "filters",
-  "relaxed"
-]New value: +[
+  "total",
+  "results",
+  "filters",
+  "relaxed",
+  "source"
+]

Added value: +{
+  "description": "Restrict to a fragrance family: Citrus, Aquatic, Green, Aromatic Fougère, Floral, Fruity Floral, Floral Amber, Chypre, Woody, Woody Spicy, Amber, Amber Vanilla, Gourmand, Leather, Musky",
+  "maxLength": 40,
+  "type": "string"
+}

Previous value: -"Who the perfume is marketed for."New value: +"Who the perfume is marketed for. men/women also include unisex perfumes."

Removed value: -{
-  "description": "Maximum \"from\" price in EUR including VAT",
-  "exclusiveMinimum": 0,
-  "maximum": 1000,
-  "type": "number"
-}

Added value: +{
+  "enum": [
+    "daytime",
+    "office",
+    "casual",
+    "evening",
+    "date night",
+    "special occasion"
+  ],
+  "type": "string"
+}

Previous value: -"Free text: perfume name, house, notes, mood. e.g. \"fresh citrus summer for men under 15 euros\", \"oud\", \"vanilla gourmand\""New value: +"Free text: perfume name, house, notes, mood. e.g. \"fresh citrus summer for men\", \"oud\", \"vanilla gourmand for winter\""

Added value: +{
+  "enum": [
+    "spring",
+    "summer",
+    "autumn",
+    "winter"
+  ],
+  "type": "string"
+}

Removed value: -{
-  "description": "popular (default, best match first), price (cheapest first) or rating (best rated first)",
-  "enum": [
-    "popular",
-    "price",
-    "rating"
-  ],
-  "type": "string"
-}

Added value: +"string"

Added value: +{
+  "description": "Main accords, strongest first",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Removed value: -{
-  "type": "boolean"
-}

Added value: +{
+  "description": "One-sentence editorial description by 10ML's fragrance editors",
+  "type": "string"
+}

Removed value: -{
-  "const": "EUR",
-  "type": "string"
-}

Added value: +{
+  "description": "Fragrance family",
+  "type": "string"
+}

Removed value: -{
-  "description": "The same price formatted for display, e.g. \"€11.88\"",
-  "type": "string"
-}

Removed value: -{
-  "description": "Price of the smallest size in EUR including VAT",
-  "type": "number"
-}

Removed value: -[
-  {
-    "enum": [
-      "men",
-      "women",
-      "unisex"
-    ],
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

Added value: +[
+  "men",
+  "women",
+  "unisex"
+]

Added value: +"string"

Added value: +{
+  "description": "A 10ML guide about this perfume",
+  "type": "string"
+}

Removed value: -{
-  "description": "Stable 10ML identifier, usable with get_perfume",
-  "type": "string"
-}

Added value: +{
+  "description": "The house page on 10ml.com",
+  "type": "string"
+}

Added value: +{
+  "description": "Stable Fragrance Index identifier, usable with get_perfume and find_similar_perfumes",
+  "type": "string"
+}

Removed value: -{
-  "type": [
-    "string",
-    "null"
-  ]
-}

Added value: +{
+  "description": "The defining notes",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Removed value: -{
-  "type": "boolean"
-}

Removed value: -{
-  "items": {
-    "type": "string"
-  },
-  "type": "array"
-}

Removed value: -{
-  "type": "boolean"
-}

Removed value: -{
-  "anyOf": [
-    {
-      "additionalProperties": false,
-      "properties": {
-        "count": {
-          "type": "number"
-        },
-        "value": {
-          "type": "number"
-        }
-      },
-      "required": [
-        "value",
-        "count"
-      ],
-      "type": "object"
-    },
-    {
-      "type": "null"
-    }
-  ]
-}

Removed value: -{
-  "description": "Decant sizes in ml available at 10ML",
-  "items": {
-    "type": "number"
-  },
-  "type": "array"
-}

Previous value: -"Product page on 10ml.com"New value: +"\"Try it at 10ML\": find this perfume on 10ml.com"

Added value: +{
+  "description": "Launch year",
+  "type": "number"
+}

Previous value: -[
-  "handle",
-  "name",
-  "house",
-  "gender",
-  "fromPriceEur",
-  "fromPrice",
-  "currency",
-  "sizesMl",
-  "notes",
-  "rating",
-  "bestseller",
-  "newRelease",
-  "onSale",
-  "url",
-  "imageUrl"
-]New value: +[
+  "id",
+  "name",
+  "house",
+  "gender",
+  "family",
+  "accords",
+  "keyNotes",
+  "character",
+  "url"
+]