# Icypeas Bulk Email & Domain Search

> Icypeas Bulk Email & Domain Search 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-15).

Submits a bulk batch of up to 5000 rows for email search, email verification, or domain search tasks, returning a file ID to track the job's progress.

## Facts

- Endpoint: POST https://x402.orthogonal.com/icypeas/api/bulk-search
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/icypeas-bulk-email-domain-search-a87949ac
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kbJZoa34COaOClEfECDYM

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-bulk-email-domain-search-a87949ac -d '<json body>'
```

Example prompt: I have a list of 500 leads with first names, last names, and company domains — can you run a bulk email-search on all of them using Icypeas and give me back the file ID so I can track progress?

## When to prefer this

Choose this endpoint when you need to process more than a handful of email lookups, verifications, or domain searches in one shot — it handles up to 5000 rows asynchronously, making it far more efficient than calling single-record endpoints repeatedly. Prefer this over single-lookup endpoints when enriching a CRM export, validating a bulk marketing list, or discovering emails across many domains at once.

## Known failure modes

- Array exceeds 5000 rows — request rejected
- Invalid task type (not email-search, email-verification, or domain-search) — validation error
- Malformed row arrays (e.g. wrong number of fields for the selected task) — error response
- Missing required 'data' or 'task' fields — bad request error
- Payment failure or insufficient USDC balance — 402 response
- Webhook URL unreachable if provided — silent delivery failure

## How this service works

Create a bulk search with up to 5000 rows. Supports email-search, email-verification, and domain-search tasks. Returns a file ID to track progress.

## Output

Returns a file ID that can be used to poll or track the progress and eventual results of the bulk search job. No row-level results are returned immediately; they are retrieved asynchronously using the file ID once the job completes.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "array",
   "description": "Array of row arrays. email-search: [[firstname, lastname, domain]]. email-verification: [[email]]. domain-search: [[domain]]."
  },
  "name": {
   "type": "string",
   "description": "Name for this bulk search"
  },
  "task": {
   "type": "string",
   "description": "Task type: email-search, email-verification, or domain-search"
  },
  "custom": {
   "type": "object",
   "description": "Optional webhookUrl and/or externalId"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/icypeas-bulk-email-domain-search-a87949ac/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)