> ## Documentation Index
> Fetch the complete documentation index at: https://storeinspect.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Store search

> Search Shopify stores by ICP and technology filters.

Use `POST /stores/search` to build focused Shopify account lists.

```bash theme={null}
curl https://storeinspect.com/api/v1/stores/search \
  -H "Authorization: Bearer $STOREINSPECT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "filters": {
      "countries": ["US", "CA"],
      "categories": ["fashion", "beauty"],
      "traffic_tiers": ["200K-1M", "1M-5M"],
      "apps": {
        "any": ["Klaviyo"],
        "none": ["Recharge"]
      },
      "pixels": {
        "any": ["Meta Pixel"]
      },
      "contacts": {
        "has_revealable_contacts": true
      }
    },
    "limit": 25
  }'
```

## Response shape

Store search returns public store DTOs. Contact channels are never included in store search responses.

```json theme={null}
{
  "object": "list",
  "data": [
    {
      "id": "st_Q8vN3xRp1A2b_Dk4mY9tWz6Hc",
      "object": "store",
      "domain": "example.com",
      "name": "Example",
      "country": "US",
      "technologies": {
        "apps": ["Klaviyo"],
        "pixels": ["Meta Pixel"]
      }
    }
  ],
  "next_cursor": null,
  "request_id": "req_abc123"
}
```

## Guardrails

* Use at least one positive narrowing filter.
* Keep `limit` within the OpenAPI page-size cap.
* Use `next_cursor` for additional pages.
* Do not attempt to walk or reconstruct the database.