# Search states and provinces

Searches states by name or country codes — returns up to 100 states per page

|  |  |
| --- | --- |
| Tool id | `companyenrich.geo-states-search` |
| Platform | [Company search](https://www.orcarouter.ai/tools/companies.md) |
| Capability | [Other tools](https://www.orcarouter.ai/tools/companies/other.md) |
| Price | $0.001 per call |
| Health | OK |
| p50 latency | — |
| Success (7 days) | — |
| Runs (30 days) | — |
| Idempotent | no |
| Data class | personal |

## Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `countryCodes` | array | no | ISO alpha-2 codes to scope the search |
| `page` | integer | no | 1-based page number |
| `query` | string | no | state or province name; prefixes DO work here ('cali' matched California) |

## Call it

```bash
curl -sS https://api.orcarouter.ai/v1/tools/companyenrich.geo-states-search/run \
  -H "Authorization: Bearer $ORCAROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{}}'
```

```python
import os, requests

resp = requests.post(
    "https://api.orcarouter.ai/v1/tools/companyenrich.geo-states-search/run",
    headers={"Authorization": f"Bearer {os.environ['ORCAROUTER_API_KEY']}"},
    json={"input":{}},
)
print(resp.json())
```

## Alternatives

| Tool | Source | Price | Health |
| --- | --- | --- | --- |
| [Resolve a company name to its domain (free autocomplete)](https://www.orcarouter.ai/tools/companies/other/companies-autocomplete.md) | — | $0.001 per call | OK |
| [Search cities by name](https://www.orcarouter.ai/tools/companies/other/geo-cities-search.md) | — | $0.001 per call | OK |
| [Search countries by name](https://www.orcarouter.ai/tools/companies/other/geo-countries-search.md) | — | $0.001 per call | OK |
| [Get a country by ISO code](https://www.orcarouter.ai/tools/companies/other/geo-country-get.md) | — | $0.001 per call | OK |
| [List world regions](https://www.orcarouter.ai/tools/companies/other/geo-regions.md) | — | $0.001 per call | OK |
| [List the industry taxonomy with NAICS codes](https://www.orcarouter.ai/tools/companies/other/industries-list.md) | — | $0.001 per call | OK |
| [Autocomplete company keywords](https://www.orcarouter.ai/tools/companies/other/keywords-autocomplete.md) | — | $0.001 per call | OK |
| [Where a company's contacts are — a per-country tally](https://www.orcarouter.ai/tools/companies/other/companies-emails-locations.md) | — | $0.001 per call | OK |
| [List a company's founders](https://www.orcarouter.ai/tools/companies/other/companies-founders.md) | — | $0.011 per call | OK |
| [List investments in a company](https://www.orcarouter.ai/tools/companies/other/companies-investments.md) | — | $0.011 per call | OK |

Showing the first 10 of 17.

## FAQ

### How much does Search states and provinces cost?

Search states and provinces costs $0.001 per call: 1,000 calls cost $1.00.

### What does a $10 budget buy with Search states and provinces?

About 10000 calls at $0.001 per call.

### What inputs does Search states and provinces need?

It has no required inputs.

### How do I call Search states and provinces?

Send POST /v1/tools/{id}/run with your OrcaRouter API key and a JSON body {"input": {…}}, where {id} is the tool id POST /v1/tools/discover returns for it.

---

Markdown version of https://www.orcarouter.ai/tools/companies/other/geo-states-search