{"uid":"cap_W_Pom9RDXv4ZZ4S9REAe9","slug":"shopify-store-discovery-scraper-b21fff49","name":"Shopify Store Discovery Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://x402.186-241-26-229.sslip.io/v1/shopify-store?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"query":{"type":"string","description":"Find stores selling products matching this phrase. Leave blank only when a category is selected."},"category":{"enum":["","gid://shopify/ProductCategory/1","gid://shopify/ProductCategory/2","gid://shopify/ProductCategory/3","gid://shopify/ProductCategory/5","gid://shopify/ProductCategory/6","gid://shopify/ProductCategory/7","gid://shopify/ProductCategory/9","gid://shopify/ProductCategory/10","gid://shopify/ProductCategory/15","gid://shopify/ProductCategory/69","gid://shopify/ProductCategory/209","gid://shopify/ProductCategory/251","gid://shopify/ProductCategory/267","gid://shopify/ProductCategory/285"],"type":"string","default":"","description":"Optionally narrow discovery to a product category, or select a category without a keyword."},"maxItems":{"type":"integer","default":50,"maximum":10000,"minimum":1,"description":"Maximum unique store records to return."},"maxPages":{"type":"integer","default":100,"maximum":1000,"minimum":1,"description":"Stop discovery after this many search pages even when more results are available. Each page usually has 30 product matches."},"storeLocation":{"enum":["","US","GB","CA","AU","NZ","IE","DE","FR","IT","ES","NL","BE","AT","CH","PT","SE","DK","FI","NO"],"type":"string","default":"","description":"Keep only stores with a public business address in this country. Stores without a listed country are excluded when this filter is set."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"id":null,"name":null,"address":null,"logoUrl":null,"shareUrl":null,"shopifyId":null,"websiteUrl":null,"myshopifyDomain":null}],"product":"shopify-store"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_kFz23Lf2xzhvPI2pVE647","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Discovers and returns structured data about Shopify stores selling products matching a keyword query or product category, with optional country filtering.","exampleAgentPrompt":"Find me up to 100 Shopify stores in the US that sell handmade soap — search across at most 50 pages and give me their names, websites, and addresses.","exampleUseCases":[{"title":"Competitor store discovery for brand","prompt":"Find me up to 200 Shopify stores selling organic skincare products in the UK, searching up to 100 pages, and return their names, websites, and addresses."},{"title":"Lead generation for B2B supplier","prompt":"I need a list of up to 500 Shopify stores selling pet supplies in the US — limit the search to 150 pages and give me each store's name, website, and myshopify domain."},{"title":"Category browsing without keyword","prompt":"Show me up to 50 Shopify stores in Canada from the apparel product category — no specific keyword needed, just browse that category and return names and URLs."}],"resultDescription":"Returns a JSON object with a count and an array of store records, each containing the store's name, address, logo URL, share URL, Shopify ID, website URL, and myshopify domain. Failed or empty runs are not billed.","failureModes":["No stores found matching the query or category — returns empty items array and count of 0, no charge","Invalid category GID provided — likely a 400 validation error","maxPages or maxItems limits too low to return meaningful results","storeLocation filter excludes stores without a listed country, potentially reducing results significantly","Network or scraper timeout on upstream Shopify search — no charge on failure"],"whenToPreferThis":"Choose this endpoint when you need structured discovery of Shopify merchants by product keyword or category, especially with country filtering. Ideal for B2B lead generation, competitive analysis, or building merchant databases. Prefer over generic web scrapers because it returns clean, structured Shopify-specific fields (myshopify domain, Shopify ID) and only charges on successful, non-empty results.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T04:15:05.176Z","isFirstParty":false,"canonicalSlug":"shopify-store-discovery-scraper-b21fff49"}