{"openapi":"3.1.0","info":{"title":"StorePolicyCheck Public Read-Only Shopify GMC Diagnostic API","version":"2.0.0","description":"Zero-credential, read-only diagnostic endpoints for auditing public Shopify storefronts across US, UK, EU, Canada & Australia before Google Merchant Center (GMC) Misrepresentation review. Checks 22 rules including verbatim shipping/return contradictions, UK/EU 14-day statutory return laws, /cart/add.js checkout sneak fees, DNS MX support email deliverability, ICANN RDAP domain age vs. founding claims, shared virtual-office addresses, ?variant= JSON-LD price parity, GMC CSV/TSV/XML feed parity, and Jan 31, 2027 500x500 px image compliance.","contact":{"name":"StorePolicyCheck Support","url":"https://storepolicycheck.com","email":"support@storepolicycheck.com"}},"servers":[{"url":"https://storepolicycheck.com"}],"paths":{"/api/scan":{"post":{"operationId":"runShopifyStorefrontAudit","summary":"Run full 15-rule read-only Shopify US/USD GMC pre-review audit","description":"Scans a public Shopify storefront URL with zero admin credentials and returns a report token link (https://storepolicycheck.com/report/{operatorToken}) revealing up to 2 verbatim conflicts free.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["inputUrl"],"properties":{"inputUrl":{"type":"string","description":"Public Shopify storefront or product URL"},"stage":{"type":"string","enum":["pre_launch","warning","suspended","item_disapproved"],"default":"suspended"},"utmSource":{"type":"string","description":"Optional attribution tag (e.g., storepolicycheck-mcp)"}}}}}},"responses":{"200":{"description":"Scan completed and report token generated"}}}},"/api/tools/image-check":{"post":{"operationId":"checkShopify500x500Images","summary":"Check up to 250 Shopify SKUs against Jan 31, 2027 500x500 px GMC image rule","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["inputUrl"],"properties":{"inputUrl":{"type":"string","description":"Public Shopify store domain or URL"}}}}}},"responses":{"200":{"description":"Structured image audit summary and failing SKUs"}}}},"/api/tools/variant-price-check":{"post":{"operationId":"checkShopifyVariantJsonLdPrice","summary":"Compare visible ?variant= buy-box price vs. ProductGroup/Offer JSON-LD & detect conflicting Shopify plugins","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["inputUrl"],"properties":{"inputUrl":{"type":"string","description":"Public Shopify product URL (with optional ?variant=ID)"}}}}}},"responses":{"200":{"description":"Variant JSON-LD comparison & detected plugins"}}}},"/api/tools/robots-check":{"post":{"operationId":"testShopifyRobotsTxt","summary":"Evaluate Shopify robots.txt per RFC 9309 for Googlebot, Storebot-Google, Googlebot-Image & AI crawlers","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["inputUrl"],"properties":{"inputUrl":{"type":"string","description":"Public Shopify storefront domain"}}}}}},"responses":{"200":{"description":"Path-by-path crawler allow/disallow test results"}}}},"/api/tools/feed-parity-check":{"post":{"operationId":"checkGmcFeedVsLiveShopify","summary":"Compare exported GMC TSV, CSV, or XML product feed against live public Shopify catalog","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["inputUrl","feedContent"],"properties":{"inputUrl":{"type":"string","description":"Public Shopify storefront domain"},"feedContent":{"type":"string","description":"Raw TSV, CSV, or Google Shopping XML feed text"}}}}}},"responses":{"200":{"description":"Feed parity summary and first 3 verbatim SKU discrepancies"}}}},"/api/tools/trust-check":{"post":{"operationId":"checkShopifyEntityEmailAndCartTrust","summary":"Audit DNS MX support email deliverability, ICANN RDAP domain age, virtual-office addresses & /cart/add.js sneak fees","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["inputUrl"],"properties":{"inputUrl":{"type":"string","description":"Public Shopify storefront domain"}}}}}},"responses":{"200":{"description":"Entity, MX, RDAP & cart sneak-fee audit results"}}}},"/api/tools/catalog-hygiene-check":{"post":{"operationId":"checkShopifyGmcCatalogHygiene","summary":"Audit up to 250 Shopify SKUs for GMC title promo spam, perpetual strikethrough sales, 0g weights & GTIN hygiene","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["inputUrl"],"properties":{"inputUrl":{"type":"string","description":"Public Shopify storefront domain"}}}}}},"responses":{"200":{"description":"Catalog hygiene summary & sample auto-cleaned Supplemental Feed rows"}}}},"/api/public/benchmark":{"get":{"operationId":"getLiveGmcBenchmarkStats","summary":"Fetch live anonymized 2026 Shopify GMC Misrepresentation empirical benchmark stats","responses":{"200":{"description":"Anonymized live benchmark JSON dataset"}}}}}}