{"openapi":"3.0.3","info":{"title":"Caelara Labs E-Commerce Suite","description":"E-commerce intelligence at the edge: product and storefront composites, JSON-LD product parsing, Shopify feed extraction, GTIN/UPC validation, price-drop comparison, ad-pixel detection, currency-aware margin math, review sentiment and SKU normalization.","version":"1.0.0","contact":{"email":"ops@caelaralabs.com","url":"https://caelaralabs.com"}},"servers":[{"url":"https://ecom.caelaralabs.com"}],"components":{"securitySchemes":{"RapidAPIKey":{"type":"apiKey","in":"header","name":"X-RapidAPI-Proxy-Secret"},"CaelaraKey":{"type":"apiKey","in":"header","name":"X-Caelara-Key"},"x402USDC":{"type":"http","scheme":"bearer","description":"x402 USDC payment on Base network"}}},"paths":{"/health":{"get":{"summary":"Health check","responses":{"200":{"description":"Service is healthy","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/product-intel-composite":{"get":{"summary":"Product page intelligence: JSON-LD product, GTIN validation, SKU normalization, review sentiment, ad pixels and price signals","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"url","in":"query","required":true,"description":"Product page URL","schema":{"type":"string"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.025","x-caelara-tier":"composite"}},"/v1/storefront-xray-composite":{"get":{"summary":"Storefront X-ray: platform, ad/analytics stack, payment options, structured data and Shopify catalog sample","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"url","in":"query","required":true,"description":"Storefront URL","schema":{"type":"string"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.025","x-caelara-tier":"composite"}},"/v1/jsonld-product-parser":{"post":{"summary":"Extract schema.org Product data (offers, ratings, reviews) from a page","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Page URL (or supply html)"},"html":{"type":"string","description":"Raw HTML (or supply url)"}},"required":[]}}}}}},"/v1/shopify-feed-extractor":{"get":{"summary":"Extract the public Shopify products.json catalog with pricing and stock summary","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"url","in":"query","required":true,"description":"Shopify store URL","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Products per page 1-250 (default 30)","schema":{"type":"integer"}},{"name":"page","in":"query","required":false,"description":"Page number (default 1)","schema":{"type":"integer"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic"}},"/v1/gtin-upc-validator":{"get":{"summary":"Validate GTIN-8/12/13/14 (UPC/EAN) check digits and convert formats","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"code","in":"query","required":true,"description":"Barcode digits","schema":{"type":"string"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic"}},"/v1/price-drop-comparator":{"post":{"summary":"Compare a price series (or old/new price) and flag drops, lows and target hits","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prices":{"type":"array","description":"Price history, oldest first (numbers or {price,date})"},"old_price":{"type":"number","description":"Previous price"},"new_price":{"type":"number","description":"Current price"},"threshold_pct":{"type":"number","description":"Drop/increase threshold percent (default 10)"},"target_price":{"type":"number","description":"Target buy price"}},"required":[]}}}}}},"/v1/ad-pixel-detector":{"post":{"summary":"Detect ad, analytics and marketing pixels (Meta, TikTok, GA4, GTM, Pinterest, etc.) with tag IDs","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Page URL (or supply html)"},"html":{"type":"string","description":"Raw HTML (or supply url)"}},"required":[]}}}}}},"/v1/currency-margin-calc":{"get":{"summary":"Margin, markup, breakeven and target price with FX rate, fees, shipping and tax","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"cost","in":"query","required":true,"description":"Unit cost","schema":{"type":"number"}},{"name":"price","in":"query","required":true,"description":"Selling price","schema":{"type":"number"}},{"name":"fx_rate","in":"query","required":false,"description":"FX multiplier cost currency to price currency (default 1)","schema":{"type":"number"}},{"name":"fee_pct","in":"query","required":false,"description":"Marketplace/payment fee percent","schema":{"type":"number"}},{"name":"fixed_fee","in":"query","required":false,"description":"Fixed fee per order","schema":{"type":"number"}},{"name":"shipping_cost","in":"query","required":false,"description":"Shipping cost in price currency","schema":{"type":"number"}},{"name":"tax_pct","in":"query","required":false,"description":"Tax percent included in price","schema":{"type":"number"}},{"name":"target_margin_pct","in":"query","required":false,"description":"Desired margin percent for suggested price","schema":{"type":"number"}},{"name":"cost_currency","in":"query","required":false,"description":"Cost currency code","schema":{"type":"string"}},{"name":"price_currency","in":"query","required":false,"description":"Price currency code","schema":{"type":"string"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic"}},"/v1/review-sentiment-parser":{"post":{"summary":"Score review sentiment with aspect breakdown (quality, price, shipping, fit, service)","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reviews":{"type":"array","description":"Array of review strings or {text, rating}"},"text":{"type":"string","description":"Newline-separated reviews"}},"required":[]}}}}}},"/v1/sku-normalizer":{"post":{"summary":"Normalize SKUs into canonical, compact and match-key forms","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"skus":{"type":"array","description":"Array of SKU strings"},"sku":{"type":"string","description":"Single SKU string"}},"required":[]}}}}}}}}