Gridscoot

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['product_id', 'retailer_id'], 'properties': {'postcode': {'type': 'string', 'pattern': '^\\d{4}$', 'description': 'AU postcode for click-and-collect availability'}, 'product_id': {'type': 'string', 'description': 'Canonical product ID'}, 'retailer_id': {'type': 'string', 'description': 'Specific retailer slug (e.g. "ebay-au")'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['product_id', 'include_shipping', 'sort_by'], 'properties': {'gtin': {'type': 'string', 'description': 'Alternative lookup by GTIN if product_id not known'}, 'sort_by': {'enum': ['total_price', 'item_price', 'delivery_speed', 'retailer_rating'], 'type': 'string', 'default': 'total_price', 'description': 'Sort order for the returned offer list'}, 'product_id': {'type': 'string', 'description': 'Canonical product ID returned by search_products'}, 'include_shipping': {'type': 'boolean', 'default': True, 'description': 'Include shipping cost in returned total (default true)'}, 'location_postcode': {'type': 'string', 'pattern': '^\\d{4}$', 'description': 'AU postcode for delivery estimation'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['product_id', 'days'], 'properties': {'days': {'type': 'integer', 'default': 90, 'maximum': 365, 'minimum': 1, 'description': 'Trailing days of history (default 90, max 365)'}, 'retailers': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Optional filter — only include these retailer slugs'}, 'product_id': {'type': 'string', 'description': 'Canonical product ID'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['country'], 'properties': {'country': {'enum': ['AU', 'NZ'], 'type': 'string', 'default': 'AU', 'description': 'Country filter (AU at MVS; NZ from Phase 2+)'}, 'category': {'type': 'string', 'description': 'Filter to retailers indexed for this category'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['query', 'in_stock_only', 'max_results'], 'properties': {'query': {'type': 'string', 'description': 'Natural language query, e.g. "15mm bent socket wrench in Melbourne with 2-day delivery"'}, 'delivery_by': {'type': 'string', 'format': 'date-time', 'pattern': '^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$', 'description': 'ISO date by which the product must be delivered'}, 'max_results': {'type': 'integer', 'default': 10, 'maximum': 50, 'minimum': 1, 'description': 'Max results to return (default 10)'}, 'category_hint': {'type': 'string', 'description': 'Category narrowing hint, e.g. "tools/hand-tools"'}, 'in_stock_only': {'type': 'boolean', 'default': True, 'description': 'Exclude out-of-stock offers (default true)'}, 'max_price_aud': {'type': 'number', 'description': 'Maximum total price including shipping, in AUD', 'exclusiveMinimum': 0}, 'min_price_aud': {'type': 'number', 'description': 'Minimum total price filter (useful to exclude scam-priced outliers)', 'exclusiveMinimum': 0}, 'location_postcode': {'type': 'string', 'pattern': '^\\d{4}$', 'description': 'AU postcode for delivery-time estimation'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['product_id', 'user_token'], 'properties': {'retailers': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Track only at these retailers (default: all)'}, 'product_id': {'type': 'string', 'description': 'Canonical product ID to track'}, 'user_token': {'type': 'string', 'description': 'User token (from /account/keys signup)'}, 'target_price_aud': {'type': 'number', 'description': 'Notify when total price (incl. shipping) drops to this AUD value or below', 'exclusiveMinimum': 0}}, 'additionalProperties': False}