Skip to main content
Use POST /stores/search to build focused Shopify account lists.
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.
{
  "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.