{ "openapi": "3.1.0", "info": { "title": "E-commerce Product & Price Intelligence API", "version": "1.0.0", "description": "Normalize licensed product feeds into searchable offers, price history, comparisons, analytics and price alerts.", "x-pricing-model": "payg", "x-free-tier-calls": 0, "x-docs-url": "", "x-dakidarts-contract-status": "published", "x-dakidarts-execution-status": "source-only" }, "servers": [ { "url": "https://api.dakidarts.com/ecommerce-product-price-api", "description": "Dakidarts direct gateway" } ], "tags": [ { "name": "Operations", "description": "Operations endpoints sourced from the E-commerce Product & Price Intelligence API implementation." }, { "name": "Products", "description": "Products endpoints sourced from the E-commerce Product & Price Intelligence API implementation." }, { "name": "Offers", "description": "Offers endpoints sourced from the E-commerce Product & Price Intelligence API implementation." }, { "name": "Prices", "description": "Prices endpoints sourced from the E-commerce Product & Price Intelligence API implementation." }, { "name": "Discovery", "description": "Discovery endpoints sourced from the E-commerce Product & Price Intelligence API implementation." }, { "name": "Alerts", "description": "Alerts endpoints sourced from the E-commerce Product & Price Intelligence API implementation." } ], "paths": { "/healthz": { "get": { "summary": "Healthz", "description": "Liveness check", "operationId": "ecommerce-product-price-api_get_healthz", "tags": [ "Operations" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/readyz": { "get": { "summary": "Readyz", "description": "Database readiness check", "operationId": "ecommerce-product-price-api_get_readyz", "tags": [ "Operations" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/v1/products/search": { "get": { "summary": "Search", "description": "Search and filter products", "operationId": "ecommerce-product-price-api_get_v1_products_search", "tags": [ "Products" ], "parameters": [ { "name": "q", "in": "query", "required": true, "description": "Product name, brand, GTIN, or MPN", "schema": { "type": "string" } }, { "name": "category", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "brand", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "marketplace", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "min_price", "in": "query", "required": false, "description": "", "schema": { "type": "number" } }, { "name": "max_price", "in": "query", "required": false, "description": "", "schema": { "type": "number" } }, { "name": "in_stock", "in": "query", "required": false, "description": "", "schema": { "type": "boolean", "default": false } }, { "name": "sort", "in": "query", "required": false, "description": "", "schema": { "type": "string", "enum": [ "relevance", "price_asc", "price_desc", "updated_desc" ] } }, { "name": "page", "in": "query", "required": false, "description": "", "schema": { "type": "integer", "default": 1 } }, { "name": "page_size", "in": "query", "required": false, "description": "", "schema": { "type": "integer", "default": 20 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "pagination", "query" ], "properties": { "data": { "type": "array", "items": { "type": "object", "required": [ "id", "canonical_key", "gtin", "mpn", "brand", "name", "category", "rating", "review_count", "image_url", "product_url", "lowest_price", "lowest_price_currency", "offer_count", "in_stock", "updated_at" ], "properties": { "id": { "type": "string" }, "mpn": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "gtin": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "name": { "type": "string" }, "brand": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "rating": { "anyOf": [ { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ] }, "category": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "in_stock": { "type": "boolean" }, "image_url": { "anyOf": [ { "type": "string", "format": "uri", "minLength": 1 }, { "type": "null" } ] }, "updated_at": { "type": "string", "format": "date-time" }, "offer_count": { "type": "integer" }, "product_url": { "anyOf": [ { "type": "string", "format": "uri", "minLength": 1 }, { "type": "null" } ] }, "lowest_price": { "anyOf": [ { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ] }, "review_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "canonical_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "lowest_price_currency": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } } }, "query": { "type": "object", "additionalProperties": true }, "pagination": { "type": "object", "required": [ "page", "page_size", "total", "total_pages" ], "properties": { "page": { "type": "integer" }, "total": { "type": "integer" }, "page_size": { "type": "integer" }, "total_pages": { "type": "integer" } } } } } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/v1/products/compare": { "post": { "summary": "Compare", "description": "Compare up to 20 product IDs", "operationId": "ecommerce-product-price-api_post_v1_products_compare", "tags": [ "Products" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "missing_product_ids" ], "properties": { "data": { "type": "array", "items": { "type": "object", "required": [ "product", "offers" ], "properties": { "offers": { "type": "array", "items": { "type": "object", "required": [ "id", "marketplace", "seller_id", "seller_name", "title", "product_url", "price", "shipping_price", "currency", "availability", "condition", "coupon_amount", "coupon_code", "delivery_text", "delivery_days_min", "delivery_days_max", "seller_rating", "seller_review_count", "tax_included", "last_stock_change", "is_featured", "observed_at", "updated_at" ], "properties": { "id": { "type": "string" }, "price": { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "currency": { "type": "string" }, "condition": { "type": "string" }, "seller_id": { "type": "string" }, "updated_at": { "type": "string", "format": "date-time" }, "coupon_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "is_featured": { "type": "boolean" }, "marketplace": { "type": "string" }, "observed_at": { "type": "string", "format": "date-time" }, "product_url": { "anyOf": [ { "type": "string", "format": "uri", "minLength": 1 }, { "type": "null" } ] }, "seller_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "availability": { "type": "string" }, "tax_included": { "type": "boolean" }, "coupon_amount": { "anyOf": [ { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ] }, "delivery_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "seller_rating": { "anyOf": [ { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ] }, "shipping_price": { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, "delivery_days_max": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "delivery_days_min": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "last_stock_change": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "seller_review_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } } }, "product": { "type": "object", "required": [ "id", "canonical_key", "gtin", "mpn", "brand", "name", "category", "rating", "review_count", "image_url", "product_url", "lowest_price", "lowest_price_currency", "offer_count", "in_stock", "updated_at" ], "properties": { "id": { "type": "string" }, "mpn": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "gtin": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "name": { "type": "string" }, "brand": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "rating": { "anyOf": [ { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ] }, "category": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "in_stock": { "type": "boolean" }, "image_url": { "anyOf": [ { "type": "string", "format": "uri", "minLength": 1 }, { "type": "null" } ] }, "updated_at": { "type": "string", "format": "date-time" }, "offer_count": { "type": "integer" }, "product_url": { "anyOf": [ { "type": "string", "format": "uri", "minLength": 1 }, { "type": "null" } ] }, "lowest_price": { "anyOf": [ { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ] }, "review_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "canonical_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "lowest_price_currency": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } } } } }, "missing_product_ids": { "type": "array", "items": { "type": "string" } } } } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "product_ids": { "type": "array", "items": { "type": "string" } } }, "required": [ "product_ids" ], "example": { "product_ids": [ "PRODUCT_ID_1", "PRODUCT_ID_2" ] } } } } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/v1/products/{product_id}": { "get": { "summary": "Product Detail", "description": "Product details and current offers", "operationId": "ecommerce-product-price-api_get_v1_products_{product_id}", "tags": [ "Products" ], "parameters": [ { "name": "product_id", "in": "path", "required": true, "description": "", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "id", "canonical_key", "gtin", "mpn", "brand", "name", "category", "rating", "review_count", "image_url", "product_url", "lowest_price", "lowest_price_currency", "offer_count", "in_stock", "updated_at", "source", "source_product_id", "description", "attributes", "created_at", "last_seen_at", "offers" ], "properties": { "id": { "type": "string" }, "mpn": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "gtin": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "name": { "type": "string" }, "brand": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "offers": { "type": "array", "items": { "type": "object", "required": [ "id", "marketplace", "seller_id", "seller_name", "title", "product_url", "price", "shipping_price", "currency", "availability", "condition", "coupon_amount", "coupon_code", "delivery_text", "delivery_days_min", "delivery_days_max", "seller_rating", "seller_review_count", "tax_included", "last_stock_change", "is_featured", "observed_at", "updated_at" ], "properties": { "id": { "type": "string" }, "price": { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "currency": { "type": "string" }, "condition": { "type": "string" }, "seller_id": { "type": "string" }, "updated_at": { "type": "string", "format": "date-time" }, "coupon_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "is_featured": { "type": "boolean" }, "marketplace": { "type": "string" }, "observed_at": { "type": "string", "format": "date-time" }, "product_url": { "anyOf": [ { "type": "string", "format": "uri", "minLength": 1 }, { "type": "null" } ] }, "seller_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "availability": { "type": "string" }, "tax_included": { "type": "boolean" }, "coupon_amount": { "anyOf": [ { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ] }, "delivery_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "seller_rating": { "anyOf": [ { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ] }, "shipping_price": { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, "delivery_days_max": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "delivery_days_min": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "last_stock_change": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "seller_review_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } } }, "rating": { "anyOf": [ { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ] }, "source": { "type": "string" }, "category": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "in_stock": { "type": "boolean" }, "image_url": { "anyOf": [ { "type": "string", "format": "uri", "minLength": 1 }, { "type": "null" } ] }, "attributes": { "type": "object", "additionalProperties": true }, "created_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "offer_count": { "type": "integer" }, "product_url": { "anyOf": [ { "type": "string", "format": "uri", "minLength": 1 }, { "type": "null" } ] }, "last_seen_at": { "type": "string", "format": "date-time" }, "lowest_price": { "anyOf": [ { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ] }, "review_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "canonical_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "source_product_id": { "type": "string" }, "lowest_price_currency": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/v1/products/{product_id}/offers": { "get": { "summary": "Product Offers", "description": "Filtered current offers", "operationId": "ecommerce-product-price-api_get_v1_products_{product_id}_offers", "tags": [ "Offers" ], "parameters": [ { "name": "product_id", "in": "path", "required": true, "description": "", "schema": { "type": "string" } }, { "name": "marketplace", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "currency", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "in_stock", "in": "query", "required": false, "description": "", "schema": { "type": "boolean", "default": false } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "product_id", "total" ], "properties": { "data": { "type": "array", "items": { "type": "object", "required": [ "id", "marketplace", "seller_id", "seller_name", "title", "product_url", "price", "shipping_price", "currency", "availability", "condition", "coupon_amount", "coupon_code", "delivery_text", "delivery_days_min", "delivery_days_max", "seller_rating", "seller_review_count", "tax_included", "last_stock_change", "is_featured", "observed_at", "updated_at" ], "properties": { "id": { "type": "string" }, "price": { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "currency": { "type": "string" }, "condition": { "type": "string" }, "seller_id": { "type": "string" }, "updated_at": { "type": "string", "format": "date-time" }, "coupon_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "is_featured": { "type": "boolean" }, "marketplace": { "type": "string" }, "observed_at": { "type": "string", "format": "date-time" }, "product_url": { "anyOf": [ { "type": "string", "format": "uri", "minLength": 1 }, { "type": "null" } ] }, "seller_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "availability": { "type": "string" }, "tax_included": { "type": "boolean" }, "coupon_amount": { "anyOf": [ { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ] }, "delivery_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "seller_rating": { "anyOf": [ { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ] }, "shipping_price": { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, "delivery_days_max": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "delivery_days_min": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "last_stock_change": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "seller_review_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } } }, "total": { "type": "integer" }, "product_id": { "type": "string" } } } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/v1/products/{product_id}/price-history": { "get": { "summary": "Price History", "description": "Historical prices and availability", "operationId": "ecommerce-product-price-api_get_v1_products_{product_id}_price-history", "tags": [ "Prices" ], "parameters": [ { "name": "product_id", "in": "path", "required": true, "description": "", "schema": { "type": "string" } }, { "name": "offer_id", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "marketplace", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "since", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "until", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "description": "", "schema": { "type": "integer", "default": 100 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "product_id", "data" ], "properties": { "data": { "type": "array", "items": { "type": "object", "required": [ "offer_id", "marketplace", "seller_name", "price", "shipping_price", "landed_price", "currency", "availability", "captured_at" ], "properties": { "price": { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, "currency": { "type": "string" }, "offer_id": { "type": "string" }, "captured_at": { "type": "string", "format": "date-time" }, "marketplace": { "type": "string" }, "seller_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "availability": { "type": "string" }, "landed_price": { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, "shipping_price": { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" } } } }, "product_id": { "type": "string" } } } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/v1/products/{product_id}/analytics": { "get": { "summary": "Product Price Analytics", "description": "Historical low/high/average and price movement", "operationId": "ecommerce-product-price-api_get_v1_products_{product_id}_analytics", "tags": [ "Prices" ], "parameters": [ { "name": "product_id", "in": "path", "required": true, "description": "", "schema": { "type": "string" } }, { "name": "marketplace", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "currency", "in": "query", "required": false, "description": "", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "product_id", "marketplace", "currency", "current_lowest_landed_price", "historical_lowest_landed_price", "historical_highest_landed_price", "average_historical_landed_price", "first_observed_landed_price", "latest_observed_landed_price", "change_amount", "change_percent", "snapshot_count", "observed_from", "observed_to" ], "properties": { "currency": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "product_id": { "type": "string" }, "marketplace": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "observed_to": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "change_amount": { "anyOf": [ { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ] }, "observed_from": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "change_percent": { "anyOf": [ { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ] }, "snapshot_count": { "type": "integer" }, "current_lowest_landed_price": { "anyOf": [ { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ] }, "first_observed_landed_price": { "anyOf": [ { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ] }, "latest_observed_landed_price": { "anyOf": [ { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ] }, "historical_lowest_landed_price": { "anyOf": [ { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ] }, "average_historical_landed_price": { "anyOf": [ { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ] }, "historical_highest_landed_price": { "anyOf": [ { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ] } } } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/v1/products/{product_id}/changes": { "get": { "summary": "Product Price Changes", "description": "Price and availability change events", "operationId": "ecommerce-product-price-api_get_v1_products_{product_id}_changes", "tags": [ "Prices" ], "parameters": [ { "name": "product_id", "in": "path", "required": true, "description": "", "schema": { "type": "string" } }, { "name": "marketplace", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "currency", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "since", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "until", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "description": "", "schema": { "type": "integer", "default": 100 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "product_id", "data" ], "properties": { "data": { "type": "array", "items": { "type": "object", "required": [ "offer_id", "marketplace", "seller_name", "event_type", "previous_price", "previous_shipping_price", "previous_landed_price", "price", "shipping_price", "landed_price", "previous_availability", "availability", "currency", "captured_at" ], "properties": { "price": { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, "currency": { "type": "string" }, "offer_id": { "type": "string" }, "event_type": { "type": "string" }, "captured_at": { "type": "string", "format": "date-time" }, "marketplace": { "type": "string" }, "seller_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "availability": { "type": "string" }, "landed_price": { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, "previous_price": { "anyOf": [ { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ] }, "shipping_price": { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, "previous_availability": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "previous_landed_price": { "anyOf": [ { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ] }, "previous_shipping_price": { "anyOf": [ { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ] } } } }, "product_id": { "type": "string" } } } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/v1/marketplaces": { "get": { "summary": "Marketplaces", "description": "Marketplace inventory summary", "operationId": "ecommerce-product-price-api_get_v1_marketplaces", "tags": [ "Discovery" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "required": [ "marketplace", "product_count", "offer_count", "lowest_price", "currency" ], "properties": { "currency": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "marketplace": { "type": "string" }, "offer_count": { "type": "integer" }, "lowest_price": { "anyOf": [ { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ] }, "product_count": { "type": "integer" } } } } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/v1/categories": { "get": { "summary": "Categories", "description": "Category counts", "operationId": "ecommerce-product-price-api_get_v1_categories", "tags": [ "Discovery" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "required": [ "category", "product_count" ], "properties": { "category": { "type": "string" }, "product_count": { "type": "integer" } } } } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/v1/sources": { "get": { "summary": "Sources", "description": "Feed freshness and current source coverage", "operationId": "ecommerce-product-price-api_get_v1_sources", "tags": [ "Discovery" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "required": [ "source", "status", "last_success_at", "products_processed", "offers_processed", "snapshots_created", "product_count", "offer_count", "freshness_seconds" ], "properties": { "source": { "type": "string" }, "status": { "type": "string" }, "offer_count": { "type": "integer" }, "product_count": { "type": "integer" }, "last_success_at": { "type": "string", "format": "date-time" }, "offers_processed": { "type": "integer" }, "freshness_seconds": { "type": "integer" }, "snapshots_created": { "type": "integer" }, "products_processed": { "type": "integer" } } } } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/v1/alerts": { "post": { "summary": "Create Alert", "description": "Create a price alert", "operationId": "ecommerce-product-price-api_post_v1_alerts", "tags": [ "Alerts" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "id", "product_id", "marketplace", "target_price", "currency", "webhook_url", "one_shot", "active", "triggered_at", "delivered_at", "last_error", "created_at" ], "properties": { "id": { "type": "string" }, "active": { "type": "boolean" }, "currency": { "type": "string" }, "one_shot": { "type": "boolean" }, "created_at": { "type": "string", "format": "date-time" }, "last_error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "product_id": { "type": "string" }, "marketplace": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "webhook_url": { "anyOf": [ { "type": "string", "format": "uri", "minLength": 1 }, { "type": "null" } ] }, "delivered_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "target_price": { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, "triggered_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] } } } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "product_id": { "type": "string" }, "target_price": { "type": "number" }, "currency": { "type": "string", "default": "USD" }, "marketplace": { "type": "string" }, "webhook_url": { "type": "string" }, "one_shot": { "type": "boolean", "default": true } }, "required": [ "product_id", "target_price" ] } } } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/v1/alerts/{alert_id}": { "get": { "summary": "Get Alert", "description": "Read alert status", "operationId": "ecommerce-product-price-api_get_v1_alerts_{alert_id}", "tags": [ "Alerts" ], "parameters": [ { "name": "alert_id", "in": "path", "required": true, "description": "", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "id", "product_id", "marketplace", "target_price", "currency", "webhook_url", "one_shot", "active", "triggered_at", "delivered_at", "last_error", "created_at" ], "properties": { "id": { "type": "string" }, "active": { "type": "boolean" }, "currency": { "type": "string" }, "one_shot": { "type": "boolean" }, "created_at": { "type": "string", "format": "date-time" }, "last_error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "product_id": { "type": "string" }, "marketplace": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "webhook_url": { "anyOf": [ { "type": "string", "format": "uri", "minLength": 1 }, { "type": "null" } ] }, "delivered_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "target_price": { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, "triggered_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] } } } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true }, "delete": { "summary": "Delete Alert", "description": "Delete an alert", "operationId": "ecommerce-product-price-api_delete_v1_alerts_{alert_id}", "tags": [ "Alerts" ], "parameters": [ { "name": "alert_id", "in": "path", "required": true, "description": "", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } } }, "components": { "securitySchemes": { "ApiKeyAuth": { "type": "apiKey", "in": "header", "name": "X-API-Key" } } }, "security": [ { "ApiKeyAuth": [] } ] }