Prezzinvista - Radar dei Volantini

{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'maxLength': 400, 'description': 'The id of a document returned by search.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['id', 'title', 'text', 'url'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string', 'description': 'The page to cite, on prezzinvista.it'}, 'text': {'type': 'string', 'description': 'The document, in Italian'}, 'title': {'type': 'string'}, 'metadata': {'type': 'object', 'description': 'Type of document and its key facts'}}}

{'type': 'object', 'required': ['product'], 'properties': {'product': {'type': 'string', 'maxLength': 60, 'description': 'The product, in Italian: e.g. "pasta", "caffè", "olio di oliva", "detersivo lavatrice".'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['product', 'prices_are', 'weeks', 'stores_this_week', 'url'], 'properties': {'url': {'type': 'string', 'description': 'The product page on prezzinvista.it'}, 'weeks': {'type': 'array', 'items': {'type': 'object', 'required': ['week_start'], 'properties': {'offers': {'type': 'integer'}, 'week_start': {'type': 'string', 'description': 'Monday, YYYY-MM-DD'}, 'lowest_price_eur': {'type': 'number'}, 'typical_price_eur': {'type': 'number'}}}, 'description': 'Most recent last'}, 'offers': {'type': 'integer', 'description': 'Offers this week'}, 'source': {'type': 'string', 'description': 'Who to credit for the data'}, 'product': {'type': 'string'}, 'prices_are': {'type': 'string', 'description': 'per kg, per l, per pack (groceries) or per item (appliances)'}, 'updated_at': {'type': 'string', 'description': 'When the flyers were last read (ISO 8601). They are read again every three hours'}, 'change_note': {'type': 'string', 'description': 'When there is no percentage: how this week compares with the week before'}, 'change_percent': {'type': 'number', 'description': 'This week against the week before, only when the change is clear'}, 'stores_this_week': {'type': 'array', 'items': {'type': 'object', 'required': ['store', 'lowest_price_eur', 'offers'], 'properties': {'store': {'type': 'string'}, 'offers': {'type': 'integer'}, 'lowest_price_eur': {'type': 'number'}, 'typical_price_eur': {'type': 'number'}}}, 'description': 'Lowest first'}, 'typical_price_eur': {'type': 'number', 'description': 'Median flyer price this week'}, 'previous_typical_price_eur': {'type': 'number', 'description': 'Median the week before, when comparable'}}}

{'type': 'object', 'properties': {'city': {'type': 'string', 'maxLength': 60, 'description': '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.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Flyers to return (default 30). Nearest first with a city, largest first otherwise.'}, 'store': {'type': 'string', 'maxLength': 40, 'description': 'Only the flyers of this chain, by name: e.g. "Lidl".'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['total_flyers', 'total_offers', 'flyers'], 'properties': {'city': {'type': 'string'}, 'flyers': {'type': 'array', 'items': {'type': 'object', 'required': ['store', 'offers', 'url'], 'properties': {'url': {'type': 'string', 'description': 'The flyer on prezzinvista.it'}, 'store': {'type': 'string'}, 'offers': {'type': 'integer'}, 'valid_from': {'type': 'string', 'description': 'YYYY-MM-DD'}, 'distance_km': {'type': 'number'}, 'valid_until': {'type': 'string', 'description': 'YYYY-MM-DD'}, 'nearest_store': {'type': 'object', 'required': ['store', 'address'], 'properties': {'name': {'type': 'string', 'description': 'Name of the store'}, 'store': {'type': 'string', 'description': 'Retail chain'}, 'address': {'type': 'string', 'description': 'Street, postcode, town and province'}, 'open_now': {'type': 'boolean', 'description': 'Open at the time of the answer (Italian time), when the hours are known'}, 'distance_km': {'type': 'number', 'description': 'From the centre of the city'}, 'opening_hours': {'type': 'string', 'description': 'Weekly hours in Italian day abbreviations, when the chain publishes them: "lun-sab 8:30–20:00 · dom 9:00–13:00"'}}, 'description': 'With a city: the nearest store of the chain'}, 'stores_nearby': {'type': 'integer', 'description': 'Stores of the chain within 15 km of the city'}}}}, 'source': {'type': 'string', 'description': 'Who to credit for the data'}, 'updated_at': {'type': 'string', 'description': 'When the flyers were last read (ISO 8601). They are read again every three hours'}, 'total_flyers': {'type': 'integer'}, 'total_offers': {'type': 'integer'}}}

{'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string', 'maxLength': 200, 'description': 'What to look for, in Italian: a product, optionally with a chain and "a <city>".'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['results'], 'properties': {'results': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title', 'url'], 'properties': {'id': {'type': 'string', 'description': 'Pass it to fetch'}, 'url': {'type': 'string', 'description': 'The page to cite, on prezzinvista.it'}, 'title': {'type': 'string'}}}}}}

{'type': 'object', 'properties': {'city': {'type': 'string', 'maxLength': 60, 'description': '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.'}, 'page': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Page of results (default 1).'}, 'sort': {'enum': ['relevance', 'price', 'unit_price', 'discount', 'nearest'], 'type': 'string', 'description': '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).'}, 'limit': {'type': 'integer', 'maximum': 25, 'minimum': 1, 'description': 'Offers per page (default 10).'}, 'query': {'type': 'string', 'maxLength': 80, 'description': 'Product to look for, in Italian. Brand and product words are combined ("olio extravergine monini"). Omit to browse the biggest discounts.'}, 'stores': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 10, 'description': 'Only these chains, by name: e.g. ["Lidl", "Esselunga"].'}, 'max_price_eur': {'type': 'number', 'minimum': 0, 'description': 'Only offers at or below this price.'}, 'discounted_only': {'type': 'boolean', 'description': 'Only offers whose flyer states a higher previous price.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['total', 'page', 'pages', 'offers', 'search_url'], 'properties': {'city': {'type': 'string', 'description': 'The municipality the search was limited to'}, 'note': {'type': 'string'}, 'page': {'type': 'integer'}, 'pages': {'type': 'integer'}, 'query': {'type': 'string'}, 'total': {'type': 'integer', 'description': 'Offers matching, across all pages'}, 'offers': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'price_eur', 'store', 'url'], 'properties': {'url': {'type': 'string', 'description': 'The offer on its flyer page at prezzinvista.it'}, 'name': {'type': 'string', 'description': 'Product name as printed on the flyer'}, 'size': {'type': 'string', 'description': 'Pack size as printed, e.g. "2x250 g"'}, 'brand': {'type': 'string', 'description': 'Brand, written the same way across chains; absent when the name does not state one'}, 'store': {'type': 'string', 'description': 'Retail chain'}, 'category': {'type': 'string', 'description': 'Store department, in Italian: tells pasta from "Pasta del Capitano" toothpaste'}, 'quantity': {'type': 'number', 'description': 'Pack content as a number, in quantity_unit: "2x250 g" is 0.5'}, 'price_eur': {'type': 'number'}, 'distance_km': {'type': 'number', 'description': 'Distance of the nearest store of the chain from the centre of the city'}, 'valid_until': {'type': 'string', 'description': 'Last day of the offer, YYYY-MM-DD'}, 'quantity_unit': {'type': 'string', 'description': 'kg, l or pieces'}, 'unit_price_eur': {'type': 'number', 'description': 'Price per unit_price_per'}, 'unit_price_per': {'type': 'string', 'description': 'kg, l, or another unit'}, 'discount_percent': {'type': 'integer'}, 'previous_price_eur': {'type': 'number', 'description': 'Price before the offer, when the flyer states it'}}}}, 'source': {'type': 'string', 'description': 'Who to credit for the data'}, 'search_url': {'type': 'string', 'description': 'The same search on prezzinvista.it'}, 'updated_at': {'type': 'string', 'description': 'When the flyers were last read (ISO 8601). They are read again every three hours'}, 'typical_price': {'type': 'object', 'required': ['product', 'price_eur', 'per'], 'properties': {'per': {'type': 'string', 'description': 'kg, l, pack or item'}, 'url': {'type': 'string', 'description': 'The price trend page on prezzinvista.it'}, 'product': {'type': 'string'}, 'price_eur': {'type': 'number'}, 'change_note': {'type': 'string', 'description': 'When there is no percentage: how this week compares with the week before'}, 'change_percent': {'type': 'number', 'description': 'This week against the week before, only when the change is clear'}, 'previous_week_eur': {'type': 'number'}}, 'description': 'For everyday products: the typical (median) price in all Italian flyers this week, to judge the offers against'}, 'nearest_stores': {'type': 'array', 'items': {'type': 'object', 'required': ['store', 'address'], 'properties': {'name': {'type': 'string', 'description': 'Name of the store'}, 'store': {'type': 'string', 'description': 'Retail chain'}, 'address': {'type': 'string', 'description': 'Street, postcode, town and province'}, 'open_now': {'type': 'boolean', 'description': 'Open at the time of the answer (Italian time), when the hours are known'}, 'distance_km': {'type': 'number', 'description': 'From the centre of the city'}, 'opening_hours': {'type': 'string', 'description': 'Weekly hours in Italian day abbreviations, when the chain publishes them: "lun-sab 8:30–20:00 · dom 9:00–13:00"'}}}, 'description': 'With a city: for each chain in the offers, its nearest store, closest first'}}}