# Openmart · Brand search

Find companies, people and contact details with Openmart · Brand search from Alexandria through one Spiral API key. Search companies one row per brand, not per store, by search term, location, store count, and ownership type. An empty page costs nothing. Use businesses/search for store-level rows. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

- Provider: Alexandria
- Category: Lead Gen
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `openmart/companies/search`
- Page: https://spiral.ai/tools/alexandria/openmart/companies/search

## Pricing

Up to $0.69836 per run.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 5 minutes
- Longest run, end to end: 225 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `search_param` (required) | JSON |  | — | Filters: search_term, location (each entry with a country), num_stores, ownership_type, and more, such as {"search_term":"coffee shop","location":[{"country":"US","state":"CA"}]}. |
| `pagination` | JSON |  | — | limit (1 to 100, default 10) and encoded_cursor, copied from the previous page's encoded_cursor. Each brand returned costs 10 credits. |
| `estimate_total` | true or false |  | — | Add an approximate total match count as total. |

## Example

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "openmart/companies/search",
    "input": {
      "search_param": {}
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=openmart%2Fcompanies%2Fsearch

## Common questions

### Openmart · Brand search

**How much does Openmart · Brand search cost?**

Up to $0.69836 per run. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use Openmart · Brand search through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "openmart/companies/search"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with Alexandria to use Openmart · Brand search?**

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

**Can my AI agent use Openmart · Brand search?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

