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

# Search guardrails

> Build focused searches without trying to export the database.

StoreInspect search endpoints require focused, positive narrowing filters.

The API is built for ICP searches and enrichment workflows, not for walking or reconstructing the full StoreInspect database.

## Good filters

Use filters that describe the account or contact segment you actually need:

* Country or region
* Store category
* Traffic or revenue tier
* Installed apps or missing apps
* Pixels
* Theme
* Shopify Plus status
* Meta ads status
* Contact role, seniority, or revealable-contact availability

## Broad searches

Requests that are too broad are rejected with a structured `400` response.

```json theme={null}
{
  "error": {
    "type": "invalid_request_error",
    "code": "broad_search",
    "message": "Add at least one positive narrowing filter.",
    "param": "filters",
    "request_id": "req_abc123"
  }
}
```

Search responses also count returned rows against the monthly search-row quota.