---
ref: tool:crustdata/search-companies
name: Search companies
company: company:crustdata
workflows: []
access: [cli, api]
tags: [capability:find-prospects, category:data-provider, has:api, has:cli]
docs: https://docs.crustdata.com/api-reference/company-apis/search-companies-with-indexed-fields-only
updated: 2026-09-27
---

# Search companies

Searches Crustdata's company database with structured filters, a natural-language query or both, and returns ranked companies with a cursor for the next page.

Note: Up to 100 results per page, and every page costs credits: follow `next_cursor` only as far as you need.

## Set up

Use the first option your agent supports.

### CLI (official)

Install the command, then confirm it runs.

```sh
curl -fsSL https://static-assets.crustdata.com/cli/install.sh | sh
crustdata --version
```

Run `crustdata company search`.

Set `$CRUSTDATA_API_KEY` in your environment first (get a key: https://app.crustdata.com/api-keys).

### API (official)

- Base URL: https://api.crustdata.com
- Endpoint: `POST /company/search`
- Auth: send the header `Authorization: Bearer $CRUSTDATA_API_KEY`
- Get a key: https://app.crustdata.com/api-keys
- Docs: https://docs.crustdata.com/openapi-specs/2025-11-01/introduction

Before anything else, confirm access with the cheapest read-only call, like a list or a search. Never send or change anything to test access.

## Rules

- Ask the user before anything that sends messages, costs money, or changes data, and say how many records it touches. One approval covers a batch the user has seen.
- Never print API keys.