{"openapi":"3.1.0","info":{"title":"PAL Commerce Data x402 API","version":"1.5.1","description":"Deterministic utilities paid per call with x402 Base USDC: catalog audit, GTIN validation, product-feed diff, x402 declaration validation, and standard or batch prioritized catalog remediation.","x-guidance":"Use this API when an autonomous agent needs deterministic ecommerce catalog QA or remediation. Choose the $20 bulk remediation route for up to 2,000 records, the $5 batch route for up to 500 records, the $1 standard remediation route for smaller catalogs, and the lower-cost audit, GTIN, feed-diff, or x402 validation tools for focused checks. Send only the fields required by each operation schema. Successful paid calls return structured JSON with concrete findings or corrective actions; unpaid calls return an x402 payment challenge.","contact":{"email":"enricoaboujaoude@gmail.com"}},"externalDocs":{"description":"PAL Commerce Data API documentation and marketplace overview","url":"https://pal-full-catalog-remediation.onrender.com/marketplace"},"servers":[{"url":"https://pal-full-catalog-remediation.onrender.com"}],"paths":{"/v1/usdc/catalog-audit":{"post":{"operationId":"auditCatalogFeedIdentifiers","summary":"Shopify and Google Merchant Center product feed audit","tags":["ecommerce","shopify","merchant-feed","google-shopping","merchant-center","catalog-validation","feed-errors","gtin","upc","ean"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["records"],"properties":{"records":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"object","additionalProperties":true}}}},"example":{"records":[{"id":"sku-100","title":"Example Product","link":"https://example.com/products/sku-100","image_link":"https://example.com/images/sku-100.jpg","gtin":"4006381333931","brand":"Example","mpn":"SKU-100","price":"19.99 USD","availability":"in_stock","identifier_exists":true}]}}}},"responses":{"200":{"description":"Structured audit result after successful payment."},"400":{"description":"Invalid catalog payload."},"402":{"description":"x402 payment required."}},"x-payment-info":{"protocol":"x402","protocols":["x402"],"version":2,"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"10000","price":{"mode":"fixed","currency":"USD","amount":"0.01"},"priceDisplay":"$0.01","payTo":"0x02d1DAe81eAdDdeD344eeE43c6f31A8E166432bF"}}},"/v1/usdc/gtin-check-one":{"get":{"operationId":"validateSingleGtin","summary":"Validate one GTIN/UPC/EAN identifier","tags":["ecommerce","gtin","upc","ean","validation"],"parameters":[{"name":"gtin","in":"query","required":true,"schema":{"type":"string"},"example":"4006381333931"}],"responses":{"200":{"description":"Single GTIN validation result after successful payment."},"400":{"description":"Missing or invalid GTIN query."},"402":{"description":"x402 payment required."}},"x-payment-info":{"protocol":"x402","protocols":["x402"],"version":2,"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"10000","price":{"mode":"fixed","currency":"USD","amount":"0.01"},"priceDisplay":"$0.01","payTo":"0x02d1DAe81eAdDdeD344eeE43c6f31A8E166432bF"}}},"/v1/usdc/gtin-check":{"post":{"operationId":"validateGtins","summary":"Validate GTIN/UPC/EAN identifiers","tags":["ecommerce","gtin","upc","ean","validation"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["gtins"],"properties":{"gtins":{"type":"array","minItems":1,"maxItems":100,"items":{"anyOf":[{"type":"string"},{"type":"number"}]}}}},"example":{"gtins":["4006381333931","036000291452"]}}}},"responses":{"200":{"description":"GTIN validation result after successful payment."},"400":{"description":"Invalid GTIN payload."},"402":{"description":"x402 payment required."}},"x-payment-info":{"protocol":"x402","protocols":["x402"],"version":2,"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"10000","price":{"mode":"fixed","currency":"USD","amount":"0.01"},"priceDisplay":"$0.01","payTo":"0x02d1DAe81eAdDdeD344eeE43c6f31A8E166432bF"}}},"/v1/usdc/feed-diff":{"post":{"operationId":"diffProductFeedSnapshots","summary":"Compare product-feed snapshots","tags":["ecommerce","product-feed","change-detection"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["before","after"],"properties":{"before":{"type":"array","maxItems":100,"items":{"type":"object","additionalProperties":true}},"after":{"type":"array","maxItems":100,"items":{"type":"object","additionalProperties":true}}}},"example":{"before":[{"id":"sku-1","price":"19.99 USD","availability":"in_stock"}],"after":[{"id":"sku-1","price":"17.99 USD","availability":"in_stock"}]}}}},"responses":{"200":{"description":"Feed diff after successful payment."},"400":{"description":"Invalid feed-diff payload."},"402":{"description":"x402 payment required."}},"x-payment-info":{"protocol":"x402","protocols":["x402"],"version":2,"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"10000","price":{"mode":"fixed","currency":"USD","amount":"0.01"},"priceDisplay":"$0.01","payTo":"0x02d1DAe81eAdDdeD344eeE43c6f31A8E166432bF"}}},"/v1/usdc/catalog-remediation-bulk":{"post":{"operationId":"remediateCatalogFeedBulk","summary":"Generate a prioritized remediation plan for up to 2,000 products","tags":["ecommerce","merchant-feed","google-shopping","catalog-remediation","bulk","full-catalog"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["records"],"properties":{"records":{"type":"array","minItems":1,"maxItems":2000,"items":{"type":"object","additionalProperties":true}}}},"example":{"records":[{"id":"sku-100","title":"Example Product","link":"https://example.com/products/sku-100","image_link":"https://example.com/images/sku-100.jpg","gtin":"4006381333931","brand":"Example","mpn":"SKU-100","price":"19.99 USD","availability":"in_stock","identifier_exists":true}]}}}},"responses":{"200":{"description":"Full-catalog remediation plan after successful payment."},"400":{"description":"Invalid catalog payload."},"402":{"description":"x402 payment required."}},"x-payment-info":{"protocol":"x402","protocols":["x402"],"version":2,"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"20000000","price":{"mode":"fixed","currency":"USD","amount":"20.00"},"priceDisplay":"$20.00","payTo":"0x02d1DAe81eAdDdeD344eeE43c6f31A8E166432bF"}}},"/v1/usdc/catalog-remediation-batch":{"post":{"operationId":"remediateCatalogFeedBatch","summary":"Generate a prioritized remediation plan for up to 500 products","tags":["ecommerce","merchant-feed","google-shopping","catalog-remediation","batch"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["records"],"properties":{"records":{"type":"array","minItems":1,"maxItems":500,"items":{"type":"object","additionalProperties":true}}}},"example":{"records":[{"id":"sku-100","title":"Example Product","link":"https://example.com/products/sku-100","image_link":"https://example.com/images/sku-100.jpg","gtin":"4006381333931","brand":"Example","mpn":"SKU-100","price":"19.99 USD","availability":"in_stock","identifier_exists":true}]}}}},"responses":{"200":{"description":"Batch remediation plan after successful payment."},"400":{"description":"Invalid catalog payload."},"402":{"description":"x402 payment required."}},"x-payment-info":{"protocol":"x402","protocols":["x402"],"version":2,"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"5000000","price":{"mode":"fixed","currency":"USD","amount":"5.00"},"priceDisplay":"$5.00","payTo":"0x02d1DAe81eAdDdeD344eeE43c6f31A8E166432bF"}}},"/v1/usdc/catalog-remediation":{"post":{"operationId":"remediateCatalogFeed","summary":"Generate a prioritized catalog remediation plan","tags":["ecommerce","merchant-feed","google-shopping","catalog-remediation"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["records"],"properties":{"records":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"object","additionalProperties":true}}}},"example":{"records":[{"id":"sku-100","title":"Example Product","link":"https://example.com/products/sku-100","image_link":"https://example.com/images/sku-100.jpg","gtin":"4006381333931","brand":"Example","mpn":"SKU-100","price":"19.99 USD","availability":"in_stock","identifier_exists":true}]}}}},"responses":{"200":{"description":"Prioritized remediation plan after successful payment."},"400":{"description":"Invalid catalog payload."},"402":{"description":"x402 payment required."}},"x-payment-info":{"protocol":"x402","protocols":["x402"],"version":2,"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"1000000","price":{"mode":"fixed","currency":"USD","amount":"1.00"},"priceDisplay":"$1.00","payTo":"0x02d1DAe81eAdDdeD344eeE43c6f31A8E166432bF"}}},"/v1/usdc/x402-seller-integrity":{"get":{"operationId":"auditX402SellerIntegrity","summary":"Audit x402 seller integrity, discovery and machine-buyability","tags":["x402","seller-trust","integrity","agent-commerce","routing"],"parameters":[{"name":"origin","in":"query","required":true,"schema":{"type":"string","format":"uri"},"example":"https://example.com"},{"name":"route","in":"query","required":false,"schema":{"type":"string"},"example":"/api/data"}],"responses":{"200":{"description":"Runtime seller-integrity report after successful payment."},"400":{"description":"Invalid seller origin or route."},"402":{"description":"x402 payment required."},"502":{"description":"Public readiness/index upstream temporarily unavailable."}},"x-payment-info":{"protocol":"x402","protocols":["x402"],"version":2,"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"10000","price":{"mode":"fixed","currency":"USD","amount":"0.01"},"priceDisplay":"$0.01","payTo":"0x02d1DAe81eAdDdeD344eeE43c6f31A8E166432bF"}}},"/v1/usdc/shopify-product-availability":{"get":{"operationId":"checkShopifyProductAvailability","summary":"Check current Shopify product availability and variants","tags":["shopify","ecommerce","product-availability","product-detail","variants"],"parameters":[{"name":"url","in":"query","required":true,"description":"Public Shopify storefront product URL containing /products/{handle}.","schema":{"type":"string","format":"uri"},"example":"https://example-shop.com/products/example-product"}],"responses":{"200":{"description":"Current product and variant availability after successful payment."},"400":{"description":"Invalid or unsafe product URL."},"402":{"description":"x402 payment required."},"404":{"description":"Product not found."},"502":{"description":"Shopify storefront could not be read safely."}},"x-payment-info":{"protocol":"x402","protocols":["x402"],"version":2,"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"5000","price":{"mode":"fixed","currency":"USD","amount":"0.005"},"priceDisplay":"$0.005","payTo":"0x02d1DAe81eAdDdeD344eeE43c6f31A8E166432bF"}}},"/v1/usdc/x402-validate":{"post":{"operationId":"validateX402Declaration","summary":"Validate an x402 v2 payment declaration","tags":["x402","payments","developer-tools","validation"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"x402Version":2,"resource":{"url":"https://example.com/api/data"},"accepts":[{"scheme":"exact","network":"eip155:8453","amount":"10000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x02d1DAe81eAdDdeD344eeE43c6f31A8E166432bF","maxTimeoutSeconds":60}]}}}},"responses":{"200":{"description":"Static x402 declaration findings after successful payment."},"400":{"description":"Invalid request wrapper."},"402":{"description":"x402 payment required."}},"x-payment-info":{"protocol":"x402","protocols":["x402"],"version":2,"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"50000","price":{"mode":"fixed","currency":"USD","amount":"0.05"},"priceDisplay":"$0.05","payTo":"0x02d1DAe81eAdDdeD344eeE43c6f31A8E166432bF"}}}}}