# Shopify Store Discovery Scraper

> Shopify Store Discovery Scraper is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Discovers and returns structured data about Shopify stores selling products matching a keyword query or product category, with optional country filtering.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/v1/shopify-store?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/shopify-store-discovery-scraper-b21fff49
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_W_Pom9RDXv4ZZ4S9REAe9

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability shopify-store-discovery-scraper-b21fff49 -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/shopify-store-discovery-scraper-b21fff49/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.186-241-26-229.sslip.io](https://www.zero.xyz/host/x402.186-241-26-229.sslip.io/llms.txt)