Server definition
- Hash
- sha256:13233ce1642d7da7734f01f7789c7299a4db312f454561f59d97042c4c5810ef
- What it is
- What a remote MCP server returned when asked what it offers: 14 tools
The blob, as servednamed by its sha256
{
"instructions": "Primini Tunisie price comparison for Tunisie only (TN). All prices are numbers in TND; use priceFormatted for display. Product names are in French. Typical flow: search_products to get a productId, then get_product, get_product_offers or analyze_price. To browse a category: find_category then get_category_products. Deals: get_deals. Coupons: get_promo_codes. Never assume prices or availability for another country; use that country's Primini server instead.",
"tools": [
{
"description": "Returns a buying recommendation for one Primini Tunisie product: current best price in TND, position in the price history (near the historical low, mid range, near the high), recent trend, a verdict (buy_now, wait, neutral, unknown) with its reasons and a confidence level, plus an optional comparison with a price you saw elsewhere (externalPrice, optional externalStore). productId comes from search_products.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"days": {
"description": "History window in days (7..730, default 180).",
"maximum": 730,
"minimum": 7,
"type": "integer"
},
"externalPrice": {
"description": "Price in TND seen outside Primini Tunisie, to compare with the market.",
"exclusiveMinimum": 0,
"maximum": 1000000000,
"type": "number"
},
"externalStore": {
"description": "Name of the store where externalPrice was seen (for example Mytek).",
"maxLength": 100,
"type": "string"
},
"productId": {
"description": "productId from search_products or any product list.",
"exclusiveMinimum": 0,
"maximum": 2147483647,
"type": "integer"
}
},
"required": [
"productId"
],
"type": "object"
},
"name": "analyze_price",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"confidence": {
"enum": [
"low",
"medium",
"high"
],
"type": "string"
},
"external": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"bestPrice": {
"type": [
"number",
"null"
]
},
"bestStore": {
"type": [
"string",
"null"
]
},
"cheaperOffers": {
"items": {
"additionalProperties": false,
"properties": {
"availability": {
"type": [
"string",
"null"
]
},
"deliveryCost": {
"type": [
"number",
"null"
]
},
"deliveryTime": {
"type": [
"string",
"null"
]
},
"isMarketplace": {
"type": "boolean"
},
"price": {
"type": [
"number",
"null"
]
},
"priceFormatted": {
"type": [
"string",
"null"
]
},
"storeId": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"storeName": {
"type": [
"string",
"null"
]
},
"storeSlug": {
"type": [
"string",
"null"
]
},
"totalPrice": {
"type": [
"number",
"null"
]
},
"updatedAt": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
}
},
"required": [
"storeId",
"storeName",
"storeSlug",
"price",
"deliveryCost",
"totalPrice",
"priceFormatted",
"availability",
"deliveryTime",
"isMarketplace",
"updatedAt",
"url"
],
"type": "object"
},
"type": "array"
},
"difference": {
"type": [
"number",
"null"
]
},
"differencePercent": {
"type": [
"number",
"null"
]
},
"price": {
"type": "number"
},
"store": {
"type": [
"string",
"null"
]
},
"verdict": {
"enum": [
"cheaper_elsewhere",
"fair",
"better_than_market"
],
"type": "string"
},
"vsHistoricalAvg": {
"type": [
"number",
"null"
]
},
"vsHistoricalMin": {
"type": [
"number",
"null"
]
}
},
"required": [
"price",
"store",
"bestPrice",
"bestStore",
"difference",
"differencePercent",
"verdict",
"vsHistoricalMin",
"vsHistoricalAvg",
"cheaperOffers"
],
"type": "object"
},
{
"type": "null"
}
]
},
"history": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"avg": {
"type": "number"
},
"dataPoints": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"max": {
"type": "number"
},
"min": {
"type": "number"
},
"percentAboveMin": {
"type": [
"number",
"null"
]
},
"percentBelowMax": {
"type": [
"number",
"null"
]
},
"periodDays": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"position": {
"anyOf": [
{
"enum": [
"near_historical_low",
"mid_range",
"near_historical_high"
],
"type": "string"
},
{
"type": "null"
}
]
},
"trend": {
"anyOf": [
{
"enum": [
"dropping",
"stable",
"rising"
],
"type": "string"
},
{
"type": "null"
}
]
},
"trendPercent": {
"type": [
"number",
"null"
]
}
},
"required": [
"periodDays",
"dataPoints",
"min",
"max",
"avg",
"trend",
"trendPercent",
"percentAboveMin",
"percentBelowMax",
"position"
],
"type": "object"
},
{
"type": "null"
}
]
},
"offers": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"count": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"maxPrice": {
"type": [
"number",
"null"
]
},
"minPrice": {
"type": [
"number",
"null"
]
}
},
"required": [
"count",
"minPrice",
"maxPrice"
],
"type": "object"
},
{
"type": "null"
}
]
},
"product": {
"additionalProperties": false,
"properties": {
"currentPrice": {
"type": [
"number",
"null"
]
},
"name": {
"type": "string"
},
"priceFormatted": {
"type": [
"string",
"null"
]
},
"productId": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"url": {
"type": [
"string",
"null"
]
}
},
"required": [
"productId",
"name",
"currentPrice",
"priceFormatted",
"url"
],
"type": "object"
},
"reasons": {
"items": {
"type": "string"
},
"type": "array"
},
"verdict": {
"enum": [
"buy_now",
"wait",
"neutral",
"unknown"
],
"type": "string"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"product",
"offers",
"history",
"verdict",
"confidence",
"reasons",
"external",
"warnings"
],
"type": "object"
},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
},
"hint": {
"type": "string"
},
"meta": {
"additionalProperties": false,
"properties": {
"country": {
"type": "string"
},
"currency": {
"type": "string"
},
"locale": {
"type": "string"
},
"site": {
"type": "string"
},
"tool": {
"type": "string"
}
},
"required": [
"site",
"country",
"currency",
"locale",
"tool"
],
"type": "object"
},
"page": {
"additionalProperties": false,
"properties": {
"hasMore": {
"type": "boolean"
},
"page": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"size": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"total": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
}
},
"required": [
"page",
"size",
"total",
"hasMore"
],
"type": "object"
}
},
"required": [
"meta"
],
"type": "object"
}
},
{
"description": "Returns a side-by-side comparison of 2 to 4 Primini Tunisie products of the same category: product summaries with best price in TND and spec rows by theme (the rows that differ plus the first ten shared ones). Inputs: productIds from search_products, get_similar_products or get_category_products.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"productIds": {
"description": "2 to 4 distinct productIds of one leaf category.",
"items": {
"description": "productId from search_products or any product list.",
"exclusiveMinimum": 0,
"maximum": 2147483647,
"type": "integer"
},
"maxItems": 4,
"minItems": 2,
"type": "array"
}
},
"required": [
"productIds"
],
"type": "object"
},
"name": "compare_products",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"category": {
"additionalProperties": false,
"properties": {
"categoryId": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"isLeaf": {
"type": [
"boolean",
"null"
]
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
}
},
"required": [
"categoryId",
"name",
"slug",
"isLeaf"
],
"type": "object"
},
"products": {
"items": {
"additionalProperties": false,
"properties": {
"brand": {
"type": [
"string",
"null"
]
},
"category": {
"type": [
"string",
"null"
]
},
"highPrice": {
"type": [
"number",
"null"
]
},
"image": {
"type": [
"string",
"null"
]
},
"lowPrice": {
"type": [
"number",
"null"
]
},
"name": {
"type": "string"
},
"offerCount": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"price": {
"type": [
"number",
"null"
]
},
"priceFormatted": {
"type": [
"string",
"null"
]
},
"productId": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"rating": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"average": {
"type": "number"
},
"count": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"average",
"count"
],
"type": "object"
},
{
"type": "null"
}
]
},
"url": {
"type": [
"string",
"null"
]
}
},
"required": [
"productId",
"name",
"brand",
"category",
"price",
"priceFormatted",
"lowPrice",
"highPrice",
"offerCount",
"rating",
"image",
"url"
],
"type": "object"
},
"type": "array"
},
"specs": {
"items": {
"additionalProperties": false,
"properties": {
"group": {
"type": "string"
},
"rows": {
"items": {
"additionalProperties": false,
"properties": {
"name": {
"type": "string"
},
"values": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"name",
"values"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"group",
"rows"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"category",
"products",
"specs"
],
"type": "object"
},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
},
"hint": {
"type": "string"
},
"meta": {
"additionalProperties": false,
"properties": {
"country": {
"type": "string"
},
"currency": {
"type": "string"
},
"locale": {
"type": "string"
},
"site": {
"type": "string"
},
"tool": {
"type": "string"
}
},
"required": [
"site",
"country",
"currency",
"locale",
"tool"
],
"type": "object"
},
"page": {
"additionalProperties": false,
"properties": {
"hasMore": {
"type": "boolean"
},
"page": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"size": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"total": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
}
},
"required": [
"page",
"size",
"total",
"hasMore"
],
"type": "object"
}
},
"required": [
"meta"
],
"type": "object"
}
},
{
"description": "Returns up to 10 Primini Tunisie categories matching a name (leaves first), with slug, parent path and isLeaf. The slug of a leaf is the identifier accepted by get_category_products. Input: a category name in the site language.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"query": {
"description": "Category name in the site language (e.g. \"Smartphones\"); case and accent insensitive.",
"maxLength": 100,
"minLength": 2,
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "find_category",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"matches": {
"items": {
"additionalProperties": false,
"properties": {
"categoryId": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"isLeaf": {
"type": "boolean"
},
"name": {
"type": "string"
},
"parentPath": {
"type": "string"
},
"slug": {
"type": "string"
}
},
"required": [
"categoryId",
"name",
"slug",
"parentPath",
"isLeaf"
],
"type": "object"
},
"type": "array"
},
"query": {
"type": "string"
}
},
"required": [
"query",
"matches"
],
"type": "object"
},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
},
"hint": {
"type": "string"
},
"meta": {
"additionalProperties": false,
"properties": {
"country": {
"type": "string"
},
"currency": {
"type": "string"
},
"locale": {
"type": "string"
},
"site": {
"type": "string"
},
"tool": {
"type": "string"
}
},
"required": [
"site",
"country",
"currency",
"locale",
"tool"
],
"type": "object"
},
"page": {
"additionalProperties": false,
"properties": {
"hasMore": {
"type": "boolean"
},
"page": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"size": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"total": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
}
},
"required": [
"page",
"size",
"total",
"hasMore"
],
"type": "object"
}
},
"required": [
"meta"
],
"type": "object"
}
},
{
"description": "Returns one page of products of a brand on Primini Tunisie (price in TND, price range, offers, rating, image, url), with the brand, its main categories and the price range. brandId from a brands facet; categoryId from find_category.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"brandId": {
"description": "brandId from a brands facet (search_products, get_category_products, get_deals).",
"exclusiveMinimum": 0,
"maximum": 2147483647,
"type": "integer"
},
"categoryId": {
"description": "categoryId from find_category or this tool's categories, to keep one category.",
"exclusiveMinimum": 0,
"maximum": 2147483647,
"type": "integer"
},
"maxPrice": {
"description": "Max price (TND).",
"exclusiveMinimum": 0,
"maximum": 1000000000,
"type": "number"
},
"minPrice": {
"description": "Min price (TND).",
"maximum": 1000000000,
"minimum": 0,
"type": "number"
},
"page": {
"description": "Page, from 1.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"size": {
"description": "Page size (default 12).",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"sort": {
"description": "Sort (default popularity).",
"enum": [
"popularity",
"rating",
"price_asc",
"price_desc",
"created_desc"
],
"type": "string"
}
},
"required": [
"brandId"
],
"type": "object"
},
"name": "get_brand_products",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"brand": {
"additionalProperties": false,
"properties": {
"brandId": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"name": {
"type": "string"
},
"productCount": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"slug": {
"type": "string"
}
},
"required": [
"brandId",
"name",
"slug",
"productCount"
],
"type": "object"
},
"categories": {
"items": {
"additionalProperties": false,
"properties": {
"categoryId": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"count": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
}
},
"required": [
"categoryId",
"name",
"slug",
"count"
],
"type": "object"
},
"type": "array"
},
"priceRange": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
}
},
"required": [
"min",
"max"
],
"type": "object"
},
{
"type": "null"
}
]
},
"products": {
"items": {
"additionalProperties": false,
"properties": {
"brand": {
"type": [
"string",
"null"
]
},
"category": {
"type": [
"string",
"null"
]
},
"highPrice": {
"type": [
"number",
"null"
]
},
"image": {
"type": [
"string",
"null"
]
},
"lowPrice": {
"type": [
"number",
"null"
]
},
"name": {
"type": "string"
},
"offerCount": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"price": {
"type": [
"number",
"null"
]
},
"priceFormatted": {
"type": [
"string",
"null"
]
},
"productId": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"rating": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"average": {
"type": "number"
},
"count": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"average",
"count"
],
"type": "object"
},
{
"type": "null"
}
]
},
"url": {
"type": [
"string",
"null"
]
}
},
"required": [
"productId",
"name",
"brand",
"category",
"price",
"priceFormatted",
"lowPrice",
"highPrice",
"offerCount",
"rating",
"image",
"url"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"brand",
"products",
"categories",
"priceRange"
],
"type": "object"
},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
},
"hint": {
"type": "string"
},
"meta": {
"additionalProperties": false,
"properties": {
"country": {
"type": "string"
},
"currency": {
"type": "string"
},
"locale": {
"type": "string"
},
"site": {
"type": "string"
},
"tool": {
"type": "string"
}
},
"required": [
"site",
"country",
"currency",
"locale",
"tool"
],
"type": "object"
},
"page": {
"additionalProperties": false,
"properties": {
"hasMore": {
"type": "boolean"
},
"page": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"size": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"total": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
}
},
"required": [
"page",
"size",
"total",
"hasMore"
],
"type": "object"
}
},
"required": [
"meta"
],
"type": "object"
}
},
{
"description": "Returns one page of products of a Primini Tunisie category (price in TND, price range, offers, rating, image, url), with the top brands, the price range and the total. minPrice and maxPrice restrict the page to a budget; sort accepts rating, price_asc, price_desc, created_desc. slug from find_category; brandId from a brands facet.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"brandId": {
"description": "brandId from a brands facet, to keep one brand.",
"exclusiveMinimum": 0,
"maximum": 2147483647,
"type": "integer"
},
"maxPrice": {
"description": "Maximum price in TND (budget ceiling).",
"exclusiveMinimum": 0,
"maximum": 1000000000,
"type": "number"
},
"minPrice": {
"description": "Minimum price in TND (budget floor).",
"maximum": 1000000000,
"minimum": 0,
"type": "number"
},
"page": {
"description": "Page, from 1.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"size": {
"description": "Page size (default 12).",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"slug": {
"description": "Category slug from find_category.",
"maxLength": 100,
"minLength": 1,
"pattern": "^[a-z0-9-]+$",
"type": "string"
},
"sort": {
"description": "Sort (default popularity).",
"enum": [
"popularity",
"rating",
"price_asc",
"price_desc",
"created_desc"
],
"type": "string"
}
},
"required": [
"slug"
],
"type": "object"
},
"name": "get_category_products",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"brands": {
"items": {
"additionalProperties": false,
"properties": {
"count": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"id": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name",
"count"
],
"type": "object"
},
"type": "array"
},
"category": {
"additionalProperties": false,
"properties": {
"categoryId": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"isLeaf": {
"type": [
"boolean",
"null"
]
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
}
},
"required": [
"categoryId",
"name",
"slug",
"isLeaf"
],
"type": "object"
},
"priceRange": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
}
},
"required": [
"min",
"max"
],
"type": "object"
},
{
"type": "null"
}
]
},
"products": {
"items": {
"additionalProperties": false,
"properties": {
"brand": {
"type": [
"string",
"null"
]
},
"category": {
"type": [
"string",
"null"
]
},
"highPrice": {
"type": [
"number",
"null"
]
},
"image": {
"type": [
"string",
"null"
]
},
"lowPrice": {
"type": [
"number",
"null"
]
},
"name": {
"type": "string"
},
"offerCount": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"price": {
"type": [
"number",
"null"
]
},
"priceFormatted": {
"type": [
"string",
"null"
]
},
"productId": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"rating": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"average": {
"type": "number"
},
"count": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"average",
"count"
],
"type": "object"
},
{
"type": "null"
}
]
},
"url": {
"type": [
"string",
"null"
]
}
},
"required": [
"productId",
"name",
"brand",
"category",
"price",
"priceFormatted",
"lowPrice",
"highPrice",
"offerCount",
"rating",
"image",
"url"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"category",
"products",
"brands",
"priceRange"
],
"type": "object"
},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
},
"hint": {
"type": "string"
},
"meta": {
"additionalProperties": false,
"properties": {
"country": {
"type": "string"
},
"currency": {
"type": "string"
},
"locale": {
"type": "string"
},
"site": {
"type": "string"
},
"tool": {
"type": "string"
}
},
"required": [
"site",
"country",
"currency",
"locale",
"tool"
],
"type": "object"
},
"page": {
"additionalProperties": false,
"properties": {
"hasMore": {
"type": "boolean"
},
"page": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"size": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"total": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
}
},
"required": [
"page",
"size",
"total",
"hasMore"
],
"type": "object"
}
},
"required": [
"meta"
],
"type": "object"
}
},
{
"description": "Returns one page of products discounted on Primini Tunisie by at least the given percent versus their highest current price (price in TND, highPrice, discountPercent, image, url), with the categories and brands of the deals. categoryId from find_category; brandId from a brands facet.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"brandId": {
"description": "brandId from a brands facet, to restrict to one brand.",
"exclusiveMinimum": 0,
"maximum": 2147483647,
"type": "integer"
},
"categoryId": {
"description": "categoryId from find_category, to restrict to one category.",
"exclusiveMinimum": 0,
"maximum": 2147483647,
"type": "integer"
},
"discount": {
"description": "Minimum discount percent versus the highest current price: 5, 10, 15, 30 (default 15).",
"enum": [
5,
10,
15,
30
],
"type": "number"
},
"maxPrice": {
"description": "Max price (TND).",
"exclusiveMinimum": 0,
"maximum": 1000000000,
"type": "number"
},
"minPrice": {
"description": "Min price (TND).",
"maximum": 1000000000,
"minimum": 0,
"type": "number"
},
"page": {
"description": "Page, from 1.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"size": {
"description": "Page size (default 12).",
"maximum": 50,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "get_deals",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"brands": {
"items": {
"additionalProperties": false,
"properties": {
"count": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"id": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name",
"count"
],
"type": "object"
},
"type": "array"
},
"categories": {
"items": {
"additionalProperties": false,
"properties": {
"count": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"id": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name",
"count"
],
"type": "object"
},
"type": "array"
},
"minDiscount": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"products": {
"items": {
"additionalProperties": false,
"properties": {
"brand": {
"type": [
"string",
"null"
]
},
"category": {
"type": [
"string",
"null"
]
},
"discountPercent": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"highPrice": {
"type": [
"number",
"null"
]
},
"image": {
"type": [
"string",
"null"
]
},
"lowPrice": {
"type": [
"number",
"null"
]
},
"name": {
"type": "string"
},
"offerCount": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"price": {
"type": [
"number",
"null"
]
},
"priceFormatted": {
"type": [
"string",
"null"
]
},
"productId": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"rating": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"average": {
"type": "number"
},
"count": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"average",
"count"
],
"type": "object"
},
{
"type": "null"
}
]
},
"url": {
"type": [
"string",
"null"
]
}
},
"required": [
"productId",
"name",
"brand",
"category",
"price",
"priceFormatted",
"lowPrice",
"highPrice",
"offerCount",
"rating",
"image",
"url",
"discountPercent"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"minDiscount",
"products",
"categories",
"brands"
],
"type": "object"
},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
},
"hint": {
"type": "string"
},
"meta": {
"additionalProperties": false,
"properties": {
"country": {
"type": "string"
},
"currency": {
"type": "string"
},
"locale": {
"type": "string"
},
"site": {
"type": "string"
},
"tool": {
"type": "string"
}
},
"required": [
"site",
"country",
"currency",
"locale",
"tool"
],
"type": "object"
},
"page": {
"additionalProperties": false,
"properties": {
"hasMore": {
"type": "boolean"
},
"page": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"size": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"total": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
}
},
"required": [
"page",
"size",
"total",
"hasMore"
],
"type": "object"
}
},
"required": [
"meta"
],
"type": "object"
}
},
{
"description": "Returns the best-price history of one Primini Tunisie product in TND: stats (min, max, avg, first, last, dataPoints, minDate, maxDate) and a {date, price} series (daily up to 90 days, weekly beyond). Inputs: productId; days 7 to 730 (default 180).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"days": {
"description": "Window in days, 7 to 730 (default 180).",
"maximum": 730,
"minimum": 7,
"type": "integer"
},
"productId": {
"description": "productId from search_products or any product list.",
"exclusiveMinimum": 0,
"maximum": 2147483647,
"type": "integer"
}
},
"required": [
"productId"
],
"type": "object"
},
"name": "get_price_history",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"periodDays": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"productId": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"series": {
"items": {
"additionalProperties": false,
"properties": {
"date": {
"type": "string"
},
"price": {
"type": "number"
}
},
"required": [
"date",
"price"
],
"type": "object"
},
"type": "array"
},
"stats": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"avg": {
"type": "number"
},
"dataPoints": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"first": {
"type": "number"
},
"last": {
"type": "number"
},
"max": {
"type": "number"
},
"maxDate": {
"type": [
"string",
"null"
]
},
"min": {
"type": "number"
},
"minDate": {
"type": [
"string",
"null"
]
}
},
"required": [
"min",
"max",
"avg",
"first",
"last",
"dataPoints",
"minDate",
"maxDate"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"productId",
"periodDays",
"stats",
"series"
],
"type": "object"
},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
},
"hint": {
"type": "string"
},
"meta": {
"additionalProperties": false,
"properties": {
"country": {
"type": "string"
},
"currency": {
"type": "string"
},
"locale": {
"type": "string"
},
"site": {
"type": "string"
},
"tool": {
"type": "string"
}
},
"required": [
"site",
"country",
"currency",
"locale",
"tool"
],
"type": "object"
},
"page": {
"additionalProperties": false,
"properties": {
"hasMore": {
"type": "boolean"
},
"page": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"size": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"total": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
}
},
"required": [
"page",
"size",
"total",
"hasMore"
],
"type": "object"
}
},
"required": [
"meta"
],
"type": "object"
}
},
{
"description": "Returns one Primini Tunisie product sheet: identity, best price in TND with discount, plain-text summary, specs by theme (max 40 rows), editorial pros and cons, variants, the 5 cheapest offers, refurbished availability, coupons and url. Inputs: exactly one of productId or ean; includeSpecs false skips the specs.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"ean": {
"description": "EAN/GTIN barcode, 8 to 14 digits.",
"maxLength": 14,
"minLength": 8,
"pattern": "^\\d{8,14}$",
"type": "string"
},
"includeSpecs": {
"description": "Include specification groups (default true).",
"type": "boolean"
},
"productId": {
"description": "productId from search_products or any product list.",
"exclusiveMinimum": 0,
"maximum": 2147483647,
"type": "integer"
}
},
"type": "object"
},
"name": "get_product",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"aiContent": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"cons": {
"items": {
"type": "string"
},
"type": "array"
},
"pros": {
"items": {
"type": "string"
},
"type": "array"
},
"summary": {
"type": [
"string",
"null"
]
},
"verdict": {
"type": [
"string",
"null"
]
}
},
"required": [
"summary",
"pros",
"cons",
"verdict"
],
"type": "object"
},
{
"type": "null"
}
]
},
"brand": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"brandId": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
},
"slug": {
"type": [
"string",
"null"
]
}
},
"required": [
"brandId",
"name",
"slug"
],
"type": "object"
},
{
"type": "null"
}
]
},
"category": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"categoryId": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"isLeaf": {
"type": [
"boolean",
"null"
]
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
}
},
"required": [
"categoryId",
"name",
"slug",
"isLeaf"
],
"type": "object"
},
{
"type": "null"
}
]
},
"coupons": {
"items": {
"additionalProperties": false,
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"endDate": {
"type": [
"string",
"null"
]
},
"storeId": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"storeName": {
"type": [
"string",
"null"
]
},
"storeSlug": {
"type": [
"string",
"null"
]
},
"title": {
"type": [
"string",
"null"
]
},
"type": {
"type": "string"
}
},
"required": [
"code",
"title",
"description",
"type",
"storeId",
"storeName",
"storeSlug",
"endDate"
],
"type": "object"
},
"type": "array"
},
"product": {
"additionalProperties": false,
"properties": {
"brand": {
"type": [
"string",
"null"
]
},
"category": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"discount": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"amount": {
"type": "number"
},
"percent": {
"type": "number"
}
},
"required": [
"percent",
"amount"
],
"type": "object"
},
{
"type": "null"
}
]
},
"ean": {
"type": [
"string",
"null"
]
},
"highPrice": {
"type": [
"number",
"null"
]
},
"image": {
"type": [
"string",
"null"
]
},
"lowPrice": {
"type": [
"number",
"null"
]
},
"name": {
"type": "string"
},
"offerCount": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"price": {
"type": [
"number",
"null"
]
},
"priceFormatted": {
"type": [
"string",
"null"
]
},
"productId": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"rating": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"average": {
"type": "number"
},
"count": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"average",
"count"
],
"type": "object"
},
{
"type": "null"
}
]
},
"sku": {
"type": [
"string",
"null"
]
},
"summary": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
}
},
"required": [
"productId",
"name",
"brand",
"category",
"price",
"priceFormatted",
"lowPrice",
"highPrice",
"offerCount",
"rating",
"image",
"url",
"ean",
"sku",
"summary",
"description",
"discount"
],
"type": "object"
},
"redirectedFrom": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"refurbished": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"minPrice": {
"type": [
"number",
"null"
]
},
"offerCount": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"offerCount",
"minPrice"
],
"type": "object"
},
{
"type": "null"
}
]
},
"specs": {
"items": {
"additionalProperties": false,
"properties": {
"group": {
"type": "string"
},
"items": {
"items": {
"additionalProperties": false,
"properties": {
"name": {
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"name",
"value"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"group",
"items"
],
"type": "object"
},
"type": "array"
},
"topOffers": {
"items": {
"additionalProperties": false,
"properties": {
"availability": {
"type": [
"string",
"null"
]
},
"deliveryCost": {
"type": [
"number",
"null"
]
},
"deliveryTime": {
"type": [
"string",
"null"
]
},
"isMarketplace": {
"type": "boolean"
},
"price": {
"type": [
"number",
"null"
]
},
"priceFormatted": {
"type": [
"string",
"null"
]
},
"storeId": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"storeName": {
"type": [
"string",
"null"
]
},
"storeSlug": {
"type": [
"string",
"null"
]
},
"totalPrice": {
"type": [
"number",
"null"
]
},
"updatedAt": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
}
},
"required": [
"storeId",
"storeName",
"storeSlug",
"price",
"deliveryCost",
"totalPrice",
"priceFormatted",
"availability",
"deliveryTime",
"isMarketplace",
"updatedAt",
"url"
],
"type": "object"
},
"type": "array"
},
"variants": {
"items": {
"additionalProperties": false,
"properties": {
"label": {
"type": "string"
},
"price": {
"type": [
"number",
"null"
]
},
"priceFormatted": {
"type": [
"string",
"null"
]
},
"productId": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"productId",
"label",
"price",
"priceFormatted"
],
"type": "object"
},
"type": "array"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"product",
"brand",
"category",
"specs",
"aiContent",
"variants",
"topOffers",
"refurbished",
"coupons",
"redirectedFrom",
"warnings"
],
"type": "object"
},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
},
"hint": {
"type": "string"
},
"meta": {
"additionalProperties": false,
"properties": {
"country": {
"type": "string"
},
"currency": {
"type": "string"
},
"locale": {
"type": "string"
},
"site": {
"type": "string"
},
"tool": {
"type": "string"
}
},
"required": [
"site",
"country",
"currency",
"locale",
"tool"
],
"type": "object"
},
"page": {
"additionalProperties": false,
"properties": {
"hasMore": {
"type": "boolean"
},
"page": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"size": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"total": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
}
},
"required": [
"page",
"size",
"total",
"hasMore"
],
"type": "object"
}
},
"required": [
"meta"
],
"type": "object"
}
},
{
"description": "Returns all store offers for one Primini Tunisie product sorted by totalPrice (price plus delivery) in TND, with store (e.g. Mytek), availability, delivery, marketplace flag and url, plus offerCount, minPrice and maxPrice. Inputs: productId from a previous result; condition, page and size are optional.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"condition": {
"description": "NEW (default) or USED (second-hand, refurbished).",
"enum": [
"NEW",
"USED"
],
"type": "string"
},
"page": {
"description": "Page, from 1 (default 1).",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"productId": {
"description": "productId from search_products or any product list.",
"exclusiveMinimum": 0,
"maximum": 2147483647,
"type": "integer"
},
"size": {
"description": "Per page (default 10, max 20).",
"maximum": 20,
"minimum": 1,
"type": "integer"
}
},
"required": [
"productId"
],
"type": "object"
},
"name": "get_product_offers",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"condition": {
"enum": [
"NEW",
"USED"
],
"type": "string"
},
"maxPrice": {
"type": [
"number",
"null"
]
},
"minPrice": {
"type": [
"number",
"null"
]
},
"offerCount": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"offers": {
"items": {
"additionalProperties": false,
"properties": {
"availability": {
"type": [
"string",
"null"
]
},
"deliveryCost": {
"type": [
"number",
"null"
]
},
"deliveryTime": {
"type": [
"string",
"null"
]
},
"isMarketplace": {
"type": "boolean"
},
"price": {
"type": [
"number",
"null"
]
},
"priceFormatted": {
"type": [
"string",
"null"
]
},
"storeId": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"storeName": {
"type": [
"string",
"null"
]
},
"storeSlug": {
"type": [
"string",
"null"
]
},
"totalPrice": {
"type": [
"number",
"null"
]
},
"updatedAt": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
}
},
"required": [
"storeId",
"storeName",
"storeSlug",
"price",
"deliveryCost",
"totalPrice",
"priceFormatted",
"availability",
"deliveryTime",
"isMarketplace",
"updatedAt",
"url"
],
"type": "object"
},
"type": "array"
},
"productId": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"productId",
"condition",
"offerCount",
"minPrice",
"maxPrice",
"offers"
],
"type": "object"
},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
},
"hint": {
"type": "string"
},
"meta": {
"additionalProperties": false,
"properties": {
"country": {
"type": "string"
},
"currency": {
"type": "string"
},
"locale": {
"type": "string"
},
"site": {
"type": "string"
},
"tool": {
"type": "string"
}
},
"required": [
"site",
"country",
"currency",
"locale",
"tool"
],
"type": "object"
},
"page": {
"additionalProperties": false,
"properties": {
"hasMore": {
"type": "boolean"
},
"page": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"size": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"total": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
}
},
"required": [
"page",
"size",
"total",
"hasMore"
],
"type": "object"
}
},
"required": [
"meta"
],
"type": "object"
}
},
{
"description": "Returns one page of coupon codes and store promotions listed on Primini Tunisie (code, title, description, type, store, endDate), site-wide or for one store. storeId from an offer or get_store; store is a name or slug.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"page": {
"description": "Page, from 1.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"size": {
"description": "Coupons per page (default 20, max 50).",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"store": {
"description": "Store name or slug (e.g. \"Mytek\"), case and accent insensitive; ignored when storeId is given.",
"maxLength": 100,
"minLength": 1,
"type": "string"
},
"storeId": {
"description": "storeId from an offer or get_store; preferred when known.",
"exclusiveMinimum": 0,
"maximum": 2147483647,
"type": "integer"
}
},
"type": "object"
},
"name": "get_promo_codes",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"coupons": {
"items": {
"additionalProperties": false,
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"endDate": {
"type": [
"string",
"null"
]
},
"storeId": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"storeName": {
"type": [
"string",
"null"
]
},
"storeSlug": {
"type": [
"string",
"null"
]
},
"title": {
"type": [
"string",
"null"
]
},
"type": {
"type": "string"
}
},
"required": [
"code",
"title",
"description",
"type",
"storeId",
"storeName",
"storeSlug",
"endDate"
],
"type": "object"
},
"type": "array"
},
"store": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": [
"string",
"null"
]
},
"storeId": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
}
},
"required": [
"storeId",
"name",
"slug"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"store",
"coupons"
],
"type": "object"
},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
},
"hint": {
"type": "string"
},
"meta": {
"additionalProperties": false,
"properties": {
"country": {
"type": "string"
},
"currency": {
"type": "string"
},
"locale": {
"type": "string"
},
"site": {
"type": "string"
},
"tool": {
"type": "string"
}
},
"required": [
"site",
"country",
"currency",
"locale",
"tool"
],
"type": "object"
},
"page": {
"additionalProperties": false,
"properties": {
"hasMore": {
"type": "boolean"
},
"page": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"size": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"total": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
}
},
"required": [
"page",
"size",
"total",
"hasMore"
],
"type": "object"
}
},
"required": [
"meta"
],
"type": "object"
}
},
{
"description": "Returns products similar to one Primini Tunisie product (same category) as summaries with best price in TND, offerCount, rating and url. Inputs: productId from search_products or get_product.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"productId": {
"description": "productId from search_products or any product list.",
"exclusiveMinimum": 0,
"maximum": 2147483647,
"type": "integer"
}
},
"required": [
"productId"
],
"type": "object"
},
"name": "get_similar_products",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"productId": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"products": {
"items": {
"additionalProperties": false,
"properties": {
"brand": {
"type": [
"string",
"null"
]
},
"category": {
"type": [
"string",
"null"
]
},
"highPrice": {
"type": [
"number",
"null"
]
},
"image": {
"type": [
"string",
"null"
]
},
"lowPrice": {
"type": [
"number",
"null"
]
},
"name": {
"type": "string"
},
"offerCount": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"price": {
"type": [
"number",
"null"
]
},
"priceFormatted": {
"type": [
"string",
"null"
]
},
"productId": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"rating": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"average": {
"type": "number"
},
"count": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"average",
"count"
],
"type": "object"
},
{
"type": "null"
}
]
},
"url": {
"type": [
"string",
"null"
]
}
},
"required": [
"productId",
"name",
"brand",
"category",
"price",
"priceFormatted",
"lowPrice",
"highPrice",
"offerCount",
"rating",
"image",
"url"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"productId",
"products"
],
"type": "object"
},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
},
"hint": {
"type": "string"
},
"meta": {
"additionalProperties": false,
"properties": {
"country": {
"type": "string"
},
"currency": {
"type": "string"
},
"locale": {
"type": "string"
},
"site": {
"type": "string"
},
"tool": {
"type": "string"
}
},
"required": [
"site",
"country",
"currency",
"locale",
"tool"
],
"type": "object"
},
"page": {
"additionalProperties": false,
"properties": {
"hasMore": {
"type": "boolean"
},
"page": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"size": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"total": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
}
},
"required": [
"page",
"size",
"total",
"hasMore"
],
"type": "object"
}
},
"required": [
"meta"
],
"type": "object"
}
},
{
"description": "Returns the profile of a store listed on Primini Tunisie: website, type, city, payments, deliveries, shipping cost and threshold, return policy, logo and rating. storeId from an offer; slug or name from an offer or the user.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"slug": {
"description": "Store slug or name (e.g. \"Mytek\"); a name is normalised to its slug.",
"maxLength": 100,
"minLength": 1,
"type": "string"
},
"storeId": {
"description": "storeId from an offer or get_promo_codes. Give storeId or slug, not both.",
"exclusiveMinimum": 0,
"maximum": 2147483647,
"type": "integer"
}
},
"type": "object"
},
"name": "get_store",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"rating": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"average": {
"type": "number"
},
"count": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"average",
"count"
],
"type": "object"
},
{
"type": "null"
}
]
},
"store": {
"additionalProperties": false,
"properties": {
"city": {
"type": [
"string",
"null"
]
},
"deliveries": {
"items": {
"type": "string"
},
"type": "array"
},
"logo": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
},
"payments": {
"items": {
"type": "string"
},
"type": "array"
},
"returnPolicy": {
"type": [
"string",
"null"
]
},
"shipping": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"amount": {
"type": "number"
},
"threshold": {
"type": [
"number",
"null"
]
}
},
"required": [
"amount",
"threshold"
],
"type": "object"
},
{
"type": "null"
}
]
},
"slug": {
"type": [
"string",
"null"
]
},
"storeId": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"type": {
"type": [
"string",
"null"
]
},
"website": {
"type": [
"string",
"null"
]
}
},
"required": [
"storeId",
"name",
"slug",
"website",
"type",
"city",
"payments",
"deliveries",
"shipping",
"returnPolicy",
"logo"
],
"type": "object"
}
},
"required": [
"store",
"rating"
],
"type": "object"
},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
},
"hint": {
"type": "string"
},
"meta": {
"additionalProperties": false,
"properties": {
"country": {
"type": "string"
},
"currency": {
"type": "string"
},
"locale": {
"type": "string"
},
"site": {
"type": "string"
},
"tool": {
"type": "string"
}
},
"required": [
"site",
"country",
"currency",
"locale",
"tool"
],
"type": "object"
},
"page": {
"additionalProperties": false,
"properties": {
"hasMore": {
"type": "boolean"
},
"page": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"size": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"total": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
}
},
"required": [
"page",
"size",
"total",
"hasMore"
],
"type": "object"
}
},
"required": [
"meta"
],
"type": "object"
}
},
{
"description": "Returns the products a store highlights on Primini Tunisie (productId, name, price in TND, oldPrice when known, url, image). storeId from an offer; slug or name from an offer or the user.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"size": {
"description": "Number of offers (default 12, max 30).",
"maximum": 30,
"minimum": 1,
"type": "integer"
},
"slug": {
"description": "Store slug or name (e.g. \"Mytek\"); a name is normalised to its slug.",
"maxLength": 100,
"minLength": 1,
"type": "string"
},
"storeId": {
"description": "storeId from an offer or get_promo_codes. Give storeId or slug, not both.",
"exclusiveMinimum": 0,
"maximum": 2147483647,
"type": "integer"
}
},
"type": "object"
},
"name": "get_store_deals",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"offers": {
"items": {
"additionalProperties": false,
"properties": {
"image": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
},
"oldPrice": {
"type": [
"number",
"null"
]
},
"price": {
"type": [
"number",
"null"
]
},
"priceFormatted": {
"type": [
"string",
"null"
]
},
"productId": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"url": {
"type": [
"string",
"null"
]
}
},
"required": [
"productId",
"name",
"price",
"priceFormatted",
"oldPrice",
"url",
"image"
],
"type": "object"
},
"type": "array"
},
"store": {
"additionalProperties": false,
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": [
"string",
"null"
]
},
"storeId": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"storeId",
"name",
"slug"
],
"type": "object"
}
},
"required": [
"store",
"offers"
],
"type": "object"
},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
},
"hint": {
"type": "string"
},
"meta": {
"additionalProperties": false,
"properties": {
"country": {
"type": "string"
},
"currency": {
"type": "string"
},
"locale": {
"type": "string"
},
"site": {
"type": "string"
},
"tool": {
"type": "string"
}
},
"required": [
"site",
"country",
"currency",
"locale",
"tool"
],
"type": "object"
},
"page": {
"additionalProperties": false,
"properties": {
"hasMore": {
"type": "boolean"
},
"page": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"size": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"total": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
}
},
"required": [
"page",
"size",
"total",
"hasMore"
],
"type": "object"
}
},
"required": [
"meta"
],
"type": "object"
}
},
{
"description": "Returns a page of Primini Tunisie products for a free-text query (productId, name, brand, best price in TND, offerCount, rating, url) with brand and category facets and the price range. Covers the whole catalogue by keyword (e.g. \"iPhone 15\"); productId in the results is the identifier accepted by the product tools. Inputs: q from the user; brand = names from the brands facet; categoryId from the categories facet or find_category.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"brand": {
"description": "Brand names (not ids), comma separated, from the brands facet.",
"maxLength": 100,
"minLength": 1,
"type": "string"
},
"categoryId": {
"description": "Numeric categoryId to restrict the search, taken from the `categories` facet or from find_category.",
"exclusiveMinimum": 0,
"maximum": 2147483647,
"type": "integer"
},
"maxPrice": {
"description": "Max price (TND).",
"exclusiveMinimum": 0,
"maximum": 1000000000,
"type": "number"
},
"minPrice": {
"description": "Min price (TND).",
"maximum": 1000000000,
"minimum": 0,
"type": "number"
},
"page": {
"description": "Page, from 1.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"q": {
"description": "Free text, e.g. \"iPhone 15\".",
"maxLength": 200,
"minLength": 2,
"type": "string"
},
"size": {
"description": "Page size (default 12).",
"maximum": 50,
"minimum": 1,
"type": "integer"
}
},
"required": [
"q"
],
"type": "object"
},
"name": "search_products",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"brands": {
"items": {
"additionalProperties": false,
"properties": {
"count": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"id": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name",
"count"
],
"type": "object"
},
"type": "array"
},
"categories": {
"items": {
"additionalProperties": false,
"properties": {
"count": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"id": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name",
"count"
],
"type": "object"
},
"type": "array"
},
"priceRange": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
}
},
"required": [
"min",
"max"
],
"type": "object"
},
{
"type": "null"
}
]
},
"products": {
"items": {
"additionalProperties": false,
"properties": {
"brand": {
"type": [
"string",
"null"
]
},
"category": {
"type": [
"string",
"null"
]
},
"highPrice": {
"type": [
"number",
"null"
]
},
"image": {
"type": [
"string",
"null"
]
},
"lowPrice": {
"type": [
"number",
"null"
]
},
"name": {
"type": "string"
},
"offerCount": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"price": {
"type": [
"number",
"null"
]
},
"priceFormatted": {
"type": [
"string",
"null"
]
},
"productId": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"rating": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"average": {
"type": "number"
},
"count": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"average",
"count"
],
"type": "object"
},
{
"type": "null"
}
]
},
"url": {
"type": [
"string",
"null"
]
}
},
"required": [
"productId",
"name",
"brand",
"category",
"price",
"priceFormatted",
"lowPrice",
"highPrice",
"offerCount",
"rating",
"image",
"url"
],
"type": "object"
},
"type": "array"
},
"query": {
"type": "string"
}
},
"required": [
"query",
"products",
"brands",
"categories",
"priceRange"
],
"type": "object"
},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
},
"hint": {
"type": "string"
},
"meta": {
"additionalProperties": false,
"properties": {
"country": {
"type": "string"
},
"currency": {
"type": "string"
},
"locale": {
"type": "string"
},
"site": {
"type": "string"
},
"tool": {
"type": "string"
}
},
"required": [
"site",
"country",
"currency",
"locale",
"tool"
],
"type": "object"
},
"page": {
"additionalProperties": false,
"properties": {
"hasMore": {
"type": "boolean"
},
"page": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"size": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"total": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
}
},
"required": [
"page",
"size",
"total",
"hasMore"
],
"type": "object"
}
},
"required": [
"meta"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:13233ce1642d7da7734f01f7789c7299a4db312f454561f59d97042c4c5810ef | sha256sum