> ## 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.

# Contact search

> Search preview-safe contacts at Shopify stores.

Use `POST /contacts/search` to find likely decision-makers before spending reveal credits.

Contact search returns preview-safe contact data. It does not return raw emails, phone numbers, or LinkedIn URLs.

```bash theme={null}
curl https://storeinspect.com/api/v1/contacts/search \
  -H "Authorization: Bearer $STOREINSPECT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "filters": {
      "roles": ["founder", "ecommerce_manager"],
      "seniority": ["owner", "executive", "manager"],
      "stores": {
        "countries": ["US"],
        "apps": {
          "any": ["Klaviyo"]
        }
      },
      "availability": {
        "has_verified_email": true
      }
    },
    "limit": 25
  }'
```

## Preview first, reveal second

Use contact search to select the contacts you actually need. Then pass those contact IDs to `POST /contacts/reveal`.

<Info>
  LinkedIn URLs are treated as reveal-gated contact channels in the API.
</Info>