{"uid":"cap_wQM0a9ziHXVH5oO3BPlHK","slug":"shopify-store-discovery-api-a674bec1","name":"Shopify Store Discovery API","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/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_1ZGXOANKffhaI1tJfVTtq","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 matching a keyword query or product category, optionally filtered by country.","exampleAgentPrompt":"Find me up to 100 Shopify stores in the US that sell yoga mats — return their names, website URLs, and addresses.","exampleUseCases":[{"title":"Competitor research in a niche","prompt":"Find me up to 200 Shopify stores selling handmade candles so I can research my competitors — only include stores based in the US."},{"title":"Lead generation for B2B outreach","prompt":"I need a list of up to 500 Shopify stores selling pet supplies, ideally UK-based, with their website URLs and addresses so my sales team can reach out."},{"title":"Market landscape mapping by category","prompt":"Search for up to 50 Shopify stores in the apparel category — I want their names, Shopify domains, and any available addresses to map the market."}],"resultDescription":"Returns a JSON object with a count of discovered stores and an array of store records, each containing the store name, address, logo URL, public website URL, myshopify domain, Shopify internal ID, and a shareable URL.","failureModes":["Empty results returned if no stores match the query or category — not charged","Query too broad may hit maxPages limit before returning maxItems records","storeLocation filter excludes stores with no listed public address, reducing result count","Invalid category GID returns an error or empty set","Network timeout on very large maxPages values"],"whenToPreferThis":"Use this endpoint when you need to discover and enumerate Shopify stores by product keyword or category, especially for competitive research, lead generation, or market mapping. Prefer it over general web scraping when you specifically need structured Shopify merchant data including myshopify domains and store addresses. It is particularly useful when filtering by country is needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T04:07:31.669Z","isFirstParty":false,"canonicalSlug":"shopify-store-discovery-api-a674bec1"}