Previous value: -"Italian municipality (comune) to search around, e.g. \"Milano\", \"Reggio Emilia\", \"Sesto San Giovanni\". Only flyers valid in stores within 15 km are returned. Omit for all of Italy."New value: +"Italian municipality (comune) to search around: where the user is, or the place they ask about, e.g. \"Milano\", \"Reggio Emilia\", \"Sesto San Giovanni\". Only flyers valid in stores within radius_km of its centre are returned. Without a place the search covers all of Italy."

Added value: +{
+  "description": "Latitude of the position of the user (WGS84, decimal degrees), together with longitude. Distances are then measured from this point, and only flyers valid in stores within radius_km of it are returned. Takes precedence over city. Used for this answer only, never stored.",
+  "maximum": 90,
+  "minimum": -90,
+  "type": "number"
+}

Added value: +{
+  "description": "Longitude of the position of the user, together with latitude.",
+  "maximum": 180,
+  "minimum": -180,
+  "type": "number"
+}

Added value: +{
+  "description": "Whether to search around the approximate position of the user that some clients share with the call (ChatGPT does). When omitted, that position is used if the call names no city and no coordinates. true: the same, and the answer is an error when no position came with the call. false: all of Italy.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "How far to look around the city centre or the coordinates, in km (default 15).",
+  "maximum": 50,
+  "minimum": 1,
+  "type": "number"
+}

Previous value: -"relevance (default with a query), price (lowest first), unit_price (lowest price per kg or litre first; only offers that state it), discount (biggest first; default without a query), nearest (closest chain first; needs city)."New value: +"relevance (default with a query), price (lowest first), unit_price (lowest price per kg or litre first; only offers that state it), discount (biggest first; default without a query), nearest (closest chain first; needs a city or coordinates)."

Previous value: -"How many chains have a current flyer that was searched: with a city, those valid there. No offer among 3 chains and no offer among 50 are different answers"New value: +"How many chains have a current flyer that was searched: with a city or coordinates, those valid there. No offer among 3 chains and no offer among 50 are different answers"

Previous value: -"The municipality the search was limited to"New value: +"The municipality the search was limited to: the one passed, or the nearest to the coordinates"

Added value: +{
+  "description": "What distance_km is measured from: the coordinates passed, the approximate position shared by the client (near_me), or the centre of the city",
+  "enum": [
+    "coordinates",
+    "client_location",
+    "city_centre"
+  ],
+  "type": "string"
+}

Previous value: -"With a city: for each chain in the offers, its nearest store, closest first"New value: +"With a city or coordinates: for each chain in the offers, its nearest store, closest first"

Previous value: -"From the centre of the city"New value: +"From the place in distances_from"

Added value: +{
+  "description": "Position of the store (WGS84)",
+  "type": "number"
+}

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

Previous value: -"With a city: verified_nearby = the chain lists a store within 15 km of it; nationwide_flyer = the flyer is valid in the whole country, a store nearby is not verified"New value: +"With a city or coordinates: verified_nearby = the chain lists a store within radius_km; nationwide_flyer = the flyer is valid in the whole country, a store nearby is not verified"

Previous value: -"Distance of the nearest store of the chain from the centre of the city"New value: +"How far the nearest store of the chain is, from the place in distances_from"

Added value: +{
+  "description": "true when the call named no place and the search was limited to the position shared by the client",
+  "type": "boolean"
+}

Added value: +{
+  "description": "The radius searched around the place, in km",
+  "type": "number"
+}

Added value: +{
+  "description": "How many chains have a current flyer that was searched: with a city, those valid there. No offer among 3 chains and no offer among 50 are different answers",
+  "type": "integer"
+}

Added value: +{
+  "description": "With a city: verified_nearby = the chain lists a store within 15 km of it; nationwide_flyer = the flyer is valid in the whole country, a store nearby is not verified",
+  "enum": [
+    "verified_nearby",
+    "nationwide_flyer"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "What the flyer prints next to the price, in Italian: loyalty card required, minimum purchase, price for several pieces. The price holds under these conditions",
+  "type": "string"
+}

Added value: +{
+  "description": "For a regional or single-store edition of the flyer: the territory it is valid in. Absent when the flyer is the same for the whole country",
+  "type": "string"
+}

Added value: +{
+  "description": "Page of the flyer where the price is printed",
+  "type": "integer"
+}

Added value: +{
+  "description": "The flyer on the website of the chain, where the price can be checked at the source",
+  "type": "string"
+}

Added value: +{
+  "description": "Present only when something makes this price, or its discount, doubtful: what and why. It is a reason to check the flyer page before relying on the number, not a correction",
+  "type": "string"
+}

Added value: +{
+  "description": "true when the conditions say the price needs the loyalty card, app or coupon of the chain. Absent otherwise: the flyer may not say",
+  "type": "boolean"
+}

Previous value: -"The offer on its flyer page at prezzinvista.it"New value: +"The offer on its flyer page at prezzinvista.it: the page of the flyer with the price on it"

Added value: +{
+  "description": "First day of the offer, YYYY-MM-DD",
+  "type": "string"
+}