{"openapi":"3.1.0","info":{"title":"markedet shopify launch watch","version":"0.3.0","description":"Shopify launch watch for e-commerce and product-research agents: send up to 20 store domains and get, per store, whether it runs Shopify, its product count, the newest products (title, URL, created and published dates, price range, tags) and flags: fresh_launch (published inside your window), held_then_published (created 14+ days before going live), long_survivor (listed for over 12 months), recently_updated (updated in the last 24 h, a hint not proof of inventory movement) and telling tags such as winner, test, tiktok or upsell. Plus a cross-store section: similar product titles launched by 2 or more of your stores in the same window. Reads only each store's public /products.json, politely.","x-guidance":"Use POST /check to see what Shopify stores launched recently. JSON body: {\"stores\": [\"example.com\", ...], \"since_days\": 7}, 1 to 20 unique domains. Price is $0.01 per store in USDC via x402 (the 402 quotes the exact amount). Each store has status, product_count, products with flags (fresh_launch, held_then_published, long_survivor, recently_updated) and interesting_tags; cross_store lists similar titles launched by 2+ stores. GET /demo is a free cached sample on one fixed store.","contact":{"name":"markedet","email":"novusops@mail.grokbot.com","url":"https://bitbucket.org/markedet/shopify-launch-watch"},"license":{"name":"MIT","url":"https://bitbucket.org/markedet/shopify-launch-watch/src/main/LICENSE"}},"servers":[{"url":"https://shopify-launch-watch.onrender.com"}],"externalDocs":{"url":"https://bitbucket.org/markedet/shopify-launch-watch","description":"source and README"},"paths":{"/check":{"post":{"operationId":"watchShopifyLaunches","summary":"New and notable products on Shopify stores, with launch flags and cross-store overlap","tags":["Paid"],"x-payment-info":{"price":{"mode":"dynamic","currency":"USD","min":"0.010000","max":"0.200000"},"protocols":[{"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":"USDC","pricePerItemUsd":"0.01","pricing":"amount = number of unique stores x pricePerItemUsd"}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckRequest"},"example":{"stores":["allbirds.com","deathwishcoffee.com"],"since_days":7}}}},"responses":{"200":{"description":"One result per store in input order, cross-store groups, summary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckResponse"},"example":{"stores":[{"store":"deathwishcoffee.com","status":"ok","is_shopify":true,"product_count":153,"flag_counts":{"fresh_launch":4,"held_then_published":2,"relaunch_likely":0,"long_survivor":61,"recently_updated":30},"recently_updated_catalogue_wide":false,"fresh_launch_bulk":false,"products":[{"title":"Boos Cruise Silicone Cup","url":"https://deathwishcoffee.com/products/boos-cruise-silicone-cup","created_at":"2026-09-17T15:48:26Z","published_at":"2026-10-22T13:39:16Z","days_created_to_published":34.9,"price":{"min":"8.00","max":"8.00"},"tags":["Merch","OTG"],"interesting_tags":[],"flags":["fresh_launch","held_then_published","recently_updated"]}]}],"cross_store":[],"summary":{"stores":2,"by_status":{"ok":2},"fresh_launches":9,"since_days":7}}}}},"402":{"description":"Payment Required: x402 v2 challenge in the PAYMENT-REQUIRED header and the body"},"422":{"description":"Invalid input (free, never charged)"},"502":{"description":"Every store failed; payment not settled"}}}},"/demo":{"get":{"operationId":"demo","summary":"Free cached sample on one fixed public store","tags":["Free"],"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/stats":{"get":{"operationId":"stats","summary":"Counters and latency since process start (free, in memory)","tags":["Free"],"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/health":{"get":{"operationId":"health","summary":"Health (free)","tags":["Free"],"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/.well-known/x402":{"get":{"operationId":"x402Discovery","summary":"x402 discovery document (free)","tags":["Free"],"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/":{"get":{"operationId":"info","summary":"Service description (free)","tags":["Free"],"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/llms.txt":{"get":{"operationId":"llmsTxt","summary":"Short description for LLMs (free)","tags":["Free"],"security":[],"responses":{"200":{"description":"OK","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/guide":{"get":{"operationId":"guide","summary":"Guide article with a real example (free, HTML)","tags":["Free"],"security":[],"responses":{"200":{"description":"OK","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/.well-known/agent-card.json":{"get":{"operationId":"agentCard","summary":"A2A agent card (free)","tags":["Free"],"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/server.json":{"get":{"operationId":"mcpServerJson","summary":"MCP registry server.json (free)","tags":["Free"],"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"components":{"schemas":{"CheckRequest":{"type":"object","required":["stores"],"additionalProperties":false,"properties":{"stores":{"type":"array","minItems":1,"maxItems":20,"items":{"type":"string","description":"store domain, e.g. example.com (scheme and path are ignored)"}},"since_days":{"type":"integer","minimum":1,"maximum":90,"default":7,"description":"launch window in days"}},"description":"1 to 20 unique store domains; price = number of unique stores x $0.01"},"CheckResponse":{"type":"object","properties":{"stores":{"type":"array","items":{"type":"object","properties":{"store":{"type":"string"},"final_host":{"type":"string"},"status":{"type":"string","enum":["ok","not_shopify","products_json_disabled","password_protected","robots_disallowed","blocked","rate_limited","refused","error"]},"is_shopify":{"type":["boolean","null"]},"product_count":{"type":"integer"},"product_count_capped":{"type":"boolean"},"newest_published_at":{"type":["string","null"]},"flag_counts":{"type":"object"},"interesting_tag_counts":{"type":"object"},"recently_updated_catalogue_wide":{"type":"boolean"},"updated_at_note":{"type":"string"},"fresh_launch_bulk":{"type":"boolean"},"fresh_launch_note":{"type":"string"},"product_count_partial":{"type":"boolean"},"partial":{"type":["string","null"]},"products":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"handle":{"type":"string"},"url":{"type":["string","null"]},"vendor":{"type":["string","null"]},"product_type":{"type":["string","null"]},"created_at":{"type":["string","null"]},"published_at":{"type":["string","null"]},"updated_at":{"type":["string","null"]},"days_created_to_published":{"type":["number","null"]},"price":{"type":"object","properties":{"min":{"type":["string","null"]},"max":{"type":["string","null"]},"compare_at_max":{"type":["string","null"]},"variants":{"type":"integer"},"available":{"type":["boolean","null"]}}},"tags":{"type":"array","items":{"type":"string"}},"interesting_tags":{"type":"array","items":{"type":"string"}},"flags":{"type":"array","items":{"type":"string","enum":["fresh_launch","held_then_published","relaunch_likely","long_survivor","recently_updated"]}}}}},"long_survivors_oldest":{"type":"array"},"recently_updated":{"type":"array"},"detail":{"type":"string"}}}},"cross_store":{"type":"array","items":{"type":"object","properties":{"stores":{"type":"array","items":{"type":"string"}},"store_count":{"type":"integer"},"shared_tokens":{"type":"array","items":{"type":"string"}},"max_similarity":{"type":["number","null"]},"products":{"type":"array"}}}},"summary":{"type":"object"},"notes":{"type":"array","items":{"type":"string"}}}}},"securitySchemes":{}}}