{"openapi":"3.1.0","info":{"title":"Shop Search","version":"0.2.0","description":"Product search for AI agents with an executable buy-path: Amazon + live Shopify storefronts, cart-to-checkout, plus deep Amazon intelligence. Run by Light Anchor, an agency operating real Amazon brands. Pay per call via MPP, no API key, no signup.","x-guidance":"Five endpoints. POST /v1/shop/cart ($0.05): {store, items:[{variantId,quantity}]} builds a real cart on any Shopify store and returns its checkoutUrl — the buyer completes payment ON the store; we never touch payment credentials. NEW: POST /v1/shop/search ($0.05) — unified product search: {\"query\":\"...\",\"stores\":[\"anyshopifystore.com\"]?} returns a normalized list where Amazon items carry enrichment routes and Shopify items are agent-EXECUTABLE (mcpEndpoint + cart instructions to a checkout URL). Data tiers, all POST with JSON {\"asin\":\"B0...\"}: /v1/amazon/product ($0.05) returns a live product snapshot in ~6s (price, availability, BSR, rating distribution, seller, images). /v1/amazon/listing-audit ($1.00) returns an instant conversion audit in ~8s: 0-100 score, letter grade, severity-ranked defects, top fixes — based on the operator checklist we use on our own brands. /v1/review-insights ($5.00) starts a deep evidence-linked review analysis (~3 min): returns {jobId, poll}; poll GET /v1/review-insights/{jobId} (free) until status SUCCEEDED. Malformed ASINs are rejected with 422 BEFORE payment settles. Calling any paid endpoint with an empty body returns a demo result so you can inspect output shape cheaply.","contact":{"email":"sangha@lightanchor.ai"}},"paths":{"/v1/amazon/product":{"post":{"operationId":"productSnapshot","summary":"Live Amazon product snapshot (~6s)","tags":["Amazon"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050000"},"protocols":[{"mpp":{"method":"tempo","intent":"charge","currency":"0x20C000000000000000000000b9537d11c60E8b50"}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"asin":{"type":"string","pattern":"^[A-Za-z0-9]{10}$","example":"B01MDTVZTZ","examples":["B01MDTVZTZ"],"description":"Amazon ASIN, e.g. B01MDTVZTZ. Omit for a free-form demo response."}},"required":["asin"]}}}},"responses":{"200":{"description":"Product snapshot","content":{"application/json":{"schema":{"type":"object","properties":{"asin":{"type":"string"},"snapshot":{"type":"object"},"fetchedAt":{"type":"string"}},"required":["asin","snapshot"]}}}},"402":{"description":"Payment Required"}}}},"/v1/amazon/listing-audit":{"post":{"operationId":"listingAudit","summary":"Instant listing audit: score, grade, ranked defects, top fixes (~8s)","tags":["Amazon"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"1.000000"},"protocols":[{"mpp":{"method":"tempo","intent":"charge","currency":"0x20C000000000000000000000b9537d11c60E8b50"}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"asin":{"type":"string","pattern":"^[A-Za-z0-9]{10}$","example":"B01MDTVZTZ","examples":["B01MDTVZTZ"],"description":"Amazon ASIN, e.g. B01MDTVZTZ. Omit for a free-form demo response."}},"required":["asin"]}}}},"responses":{"200":{"description":"Audit verdict","content":{"application/json":{"schema":{"type":"object","properties":{"asin":{"type":"string"},"score":{"type":"integer"},"grade":{"type":"string"},"findings":{"type":"array","items":{"type":"object"}},"topFixes":{"type":"array","items":{"type":"string"}}},"required":["asin","score","grade","findings"]}}}},"402":{"description":"Payment Required"}}}},"/v1/shop/search":{"post":{"operationId":"shopSearch","summary":"Unified product search: Amazon + optional Shopify storefront fan-out (~6-10s)","tags":["Search"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050000"},"protocols":[{"mpp":{"method":"tempo","intent":"charge","currency":"0x20C000000000000000000000b9537d11c60E8b50"}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","minLength":2,"description":"Natural-language product query, e.g. \"korean sunscreen spf50\""},"stores":{"type":"array","maxItems":5,"items":{"type":"string"},"description":"Optional: up to 5 Shopify store domains to search live via their storefront MCP"},"maxResults":{"type":"integer","minimum":5,"maximum":40,"default":20}},"required":["query"]}}}},"responses":{"200":{"description":"Unified ranked product list","content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"counts":{"type":"object"},"results":{"type":"array","items":{"type":"object"}}},"required":["query","results"]}}}},"402":{"description":"Payment Required"}}}},"/v1/shop/cart":{"post":{"operationId":"shopCart","summary":"Build a cart on a Shopify store and return its checkout URL (~3s)","tags":["Search"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050000"},"protocols":[{"mpp":{"method":"tempo","intent":"charge","currency":"0x20C000000000000000000000b9537d11c60E8b50"}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"store":{"type":"string","description":"Shopify store domain, e.g. allbirds.com"},"items":{"type":"array","minItems":1,"maxItems":20,"items":{"type":"object","properties":{"variantId":{"type":"string","description":"product_variant_id from /v1/shop/search results"},"quantity":{"type":"integer","minimum":1,"default":1}},"required":["variantId"]}},"cartId":{"type":"string","description":"Optional: existing cart to update"}}}}}},"responses":{"200":{"description":"Cart result with checkoutUrl (payment completes on the store, not via MPP)","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"cartId":{"type":["string","null"]},"checkoutUrl":{"type":["string","null"]}}}}}},"402":{"description":"Payment Required"}}}},"/v1/review-insights":{"post":{"operationId":"reviewInsights","summary":"Deep evidence-linked review insight report (async, ~3 min)","tags":["Amazon"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"5.000000"},"protocols":[{"mpp":{"method":"tempo","intent":"charge","currency":"0x20C000000000000000000000b9537d11c60E8b50"}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"asin":{"type":"string","pattern":"^[A-Za-z0-9]{10}$","example":"B01MDTVZTZ","examples":["B01MDTVZTZ"],"description":"Amazon ASIN"},"marketplace":{"type":"string","enum":["com","ca","co.uk","com.au","de","fr","it","es","co.jp"],"default":"com"},"maxReviews":{"type":"integer","minimum":10,"maximum":100,"default":40},"sampleStrategy":{"type":"string","enum":["balanced","recent"],"default":"balanced"}},"required":["asin"]}}}},"responses":{"200":{"description":"Job started","content":{"application/json":{"schema":{"type":"object","properties":{"jobId":{"type":"string"},"status":{"type":"string"},"poll":{"type":"string"},"etaSeconds":{"type":"integer"}},"required":["jobId","poll"]}}}},"402":{"description":"Payment Required"}}}},"/v1/review-insights/{jobId}":{"get":{"operationId":"reviewInsightsPoll","summary":"Poll a review-insights job (free)","tags":["Amazon"],"security":[],"parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Job status; includes result when SUCCEEDED","content":{"application/json":{"schema":{"type":"object","properties":{"jobId":{"type":"string"},"status":{"type":"string"},"result":{"type":["object","null"]}},"required":["jobId","status"]}}}}}}},"/":{"get":{"operationId":"serviceInfo","summary":"Service description (free)","security":[],"responses":{"200":{"description":"Service metadata"}}}}}}