# AgenticData — Full API Reference for LLMs

> Companion to https://agenticdata.host/llms.txt. Endpoint details, x402 pricing, and copy-paste examples for autonomous agents.

## Base URL

https://api.agenticdata.host

Discovery: `/.well-known/x402`, `/openapi.json`, https://www.x402scan.com/server/2c366ee8-912a-4cb8-a045-cb4600975ec3

## x402 agent workflow

1. `GET https://api.agenticdata.host/.well-known/x402` — list paywalled resources
2. `GET https://api.agenticdata.host/openapi.json` — pricing via x-payment-info
3. Call endpoint without payment → `402 Payment Required` with payment instructions
4. Sign USDC micropayment on Base (eip155:8453), retry with payment header
5. Or use MCP: `npx dataapi-mcp` with `WALLET_PRIVATE_KEY`

### AgentCash

```bash
npx agentcash onboard
npx agentcash try https://api.agenticdata.host
npx agentcash add https://api.agenticdata.host
```

## Pricing (USDC per request)

| Endpoint | Price | Description |
|----------|-------|-------------|
| POST /v1/email/verify | $0.002 | Email verification (MillionVerifier) |
| GET /v1/enrich/person | $0.01 | People & LinkedIn finder |
| POST /v1/enrich | $0.01 | People finder (JSON body) |
| POST /v1/person/lookup | $0.01 | People & phone number finder |
| POST /v1/email/find | $0.01 | Email finder (name + domain) |
| POST /v1/person/batch | $0.05 | Batch people finder |
| GET /v1/search/people | $0.05 | People finder by title, company, location |
| GET /v1/search/companies | $0.05 | Company finder by ICP |
| GET /v1/search | $0.05 | People finder (docs alias) |
| POST /v1/search/list-build | $0.05 | People finder list (sync, ~500 rows) |
| POST /v1/search/list-build/jobs | $0.50 | Async people finder export (1k–10k+) |
| GET /v1/search/list-build/jobs/{job_id} | $0.005 | Poll export job status |
| GET /v1/search/list-build/jobs/{job_id}/download | $0.005 | Download people finder CSV |

## Email verification (MillionVerifier)

Cheapest endpoint. Use before outreach or after email find.

```http
POST /v1/email/verify
Content-Type: application/json

{"email": "name@company.com"}
```

Response fields: `result` (ok, catch_all, invalid, disposable, etc.), `quality`, `is_safe_to_deliver`.

## Email finder

Permutes name@domain patterns and verifies with MillionVerifier.

```http
POST /v1/email/find
Content-Type: application/json

{
  "first_name": "Jane",
  "last_name": "Doe",
  "domain": "acme.com"
}
```

## Person enrichment

```http
GET /v1/enrich/person?email=name@company.com
```

Or POST `/v1/enrich` with body: `{ "email", "phone", "linkedin", "name", "company", "domain" }`.

## People search

```http
GET /v1/search/people?title=VP%20Sales&company=Acme&limit=25
```

Filters: title, company, company_domain, seniority, department, city, state, country.

## Company search

```http
GET /v1/search/companies?company_industry=software&limit=25
```

Filters: company name, domain, industry, SIC, NAICS, size, revenue, location.

## List building

Sync (≤~500 rows):

```http
POST /v1/search/list-build
Content-Type: application/json

{
  "companies": { "industries": ["software"], "country": ["United States"] },
  "contacts": { "titles": ["VP Sales", "Head of Growth"] },
  "limit": 100,
  "per_company_limit": 3
}
```

Async export (>500 rows):

```http
POST /v1/search/list-build/jobs
{"companies": {}, "contacts": {"titles": ["VP Sales"]}, "max_records": 5000}
```

Poll `GET /v1/search/list-build/jobs/{job_id}`, download CSV from `/download`.

## MCP tools

Package: `dataapi-mcp` (stdio MCP server)

Env: `WALLET_PRIVATE_KEY` for x402, or `DATAAPI_KEY` for subscription.

Tools: `enrich_person`, `search_people`, `search_companies`, `list_build`, `verify_email`, `find_email`.

## Human subscriptions

API keys and plans: https://agenticdata.host/dashboard

Auth header: `Authorization: Bearer ADATA_live_...` or `X-API-Key`.