# Icypeas Find Companies

> Icypeas Find Companies is a paid API for AI agents from x402.orthogonal.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Search the Icypeas lead database for companies matching filters such as name, industry, location, headcount, revenue, and keywords, returning paginated results.

## Facts

- Endpoint: POST https://x402.orthogonal.com/icypeas/api/find-companies
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/icypeas-find-companies-38e4ee8e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vPIvEdraKPHJ1Nu6ske6d

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability icypeas-find-companies-38e4ee8e -d '<json body>'
```

Example prompt: Search the Icypeas company database for SaaS companies in the United States with 50 to 500 employees and revenue between $1M and $50M — give me the first page of results.

## When to prefer this

Choose this endpoint when you need to search or filter a structured lead database for companies based on firmographic criteria such as industry, location, headcount, revenue, or keywords. It is ideal for B2B prospecting, market research, and building targeted outreach lists. Prefer this over general web search when you need structured, filterable company data with pagination support.

## Known failure modes

- Invalid or unsupported filter fields return a validation error
- Out-of-range or malformed headcount/revenue range values cause request failure
- Invalid pagination token results in an error or empty response
- Payment failure (insufficient USDC balance) blocks the request
- No matching companies returns an empty result set
- Overly broad queries may hit result limits requiring pagination

## How this service works

Search the lead database for companies matching filters. Returns paginated results. Filters: name, lid, urn, companyId, companyType, industry, location, headcount (range), headcountGrowth, revenue (range), keyword, website.

## Output

Returns a paginated list of company records matching the specified filters, including details such as company name, ID, URN, type, industry, location, headcount, revenue, and website. A pagination token is included to retrieve subsequent pages.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "query": {
   "type": "object",
   "description": "Query with include/exclude filters or range operators"
  },
  "pagination": {
   "type": "object",
   "description": "Pagination with size and token"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/icypeas-find-companies-38e4ee8e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.orthogonal.com](https://www.zero.xyz/host/x402.orthogonal.com/llms.txt)