# FullEnrich Company Search

> FullEnrich Company Search is a paid API for AI agents from fullenrich.agentscore.com, paid per call via x402, $0.2/call, status unknown (last checked 2026-09-14).

Search and filter a B2B company database by name, domain, industry, headcount, location, and other criteria, returning matching company records with pagination support.

## Facts

- Endpoint: POST https://fullenrich.agentscore.com/company/search
- Price: $0.2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fullenrich-company-search-f3f22b66
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_G1rRa3s-iEoTEwQyZXJHl

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 fullenrich-company-search-f3f22b66 -d '<json body>'
```

Example prompt: Search FullEnrich for up to 20 SaaS companies headquartered in San Francisco with between 50 and 500 employees, founded after 2010, and return their names and domains.

## When to prefer this

Use this endpoint when you need to search or filter a large B2B company database using structured criteria like industry, headcount, location, domain, or founding year. Prefer this over person-enrichment endpoints when the target entity is a company rather than an individual. It is ideal for building prospect lists, market segmentation, or verifying company metadata. The pay-per-call x402 model (no API key required) makes it suitable for autonomous agents that need frictionless access without account setup.

## Known failure modes

- No matches found if filters are too restrictive — returns total: 0 and empty matches array
- Payment failure via x402 rails if USDC balance is insufficient — call is rejected before execution
- Offset exceeding 10,000 rows without using search_after cursor causes an error
- Invalid filter values (e.g. malformed headcount objects) may return a 400 validation error
- Rate limiting or temporary unavailability of the FullEnrich upstream data source

## How this service works

Per-call B2B person + company enrichment for autonomous agents, powered by FullEnrich. Pay per successful call over agent payment rails; no API key or account.

## Output

Returns a JSON object with a 'total' count of all matching companies and a 'matches' array of company records (up to the requested limit per page), each containing at minimum the company name and domain. Also includes a search cursor for deep pagination beyond 10,000 rows.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "maximum": 100,
   "minimum": 1,
   "description": "Rows per page (price driver: the page is priced per row). Default 10, max 100."
  },
  "names": {
   "type": "array",
   "description": "Filter: names. Array of string values. Values OR within the filter, AND across filters."
  },
  "types": {
   "type": "array",
   "description": "Filter: types. Array of string values. Values OR within the filter, AND across filters."
  },
  "offset": {
   "type": "integer",
   "description": "Rows to skip (max 10000); use search_after beyond that."
  },
  "domains": {
   "type": "array",
   "description": "Filter: domains. Array of string values. Values OR within the filter, AND across filters."
  },
  "keywords": {
   "type": "array",
   "description": "Filter: keywords. Array of string values. Values OR within the filter, AND across filters."
  },
  "headcounts": {
   "type": "array",
   "description": "Filter: headcounts. Array of {min, max} objects (inclusive bounds; either may be omitted). Values OR within the filter, AND across filters."
  },
  "industries": {
   "type": "array",
   "description": "Filter: industries. Array of string values. Values OR within the filter, AND across filters."
  },
  "company_ids": {
   "type": "array",
   "description": "Filter: company ids. Array of string values. Values OR within the filter, AND across filters."
  },
  "specialties": {
   "type": "array",
   "description": "Filter: specialties. Array of string values. Values OR within the filter, AND across filters."
  },
  "search_after": {
   "type": "string",
   "description": "Cursor for deep pagination, and the ONLY way past the offset ceiling. A search response carries the next one back under this same name, so page by copying it across. Terminate on a page returning fewer rows than the limit, never on the cursor being absent: nothing guarantees it is dropped on the last page, and a loop keyed on its presence can spin and keep charging."
  },
  "founded_years": {
   "type": "array",
   "description": "Filter: founded years. Array of {min, max} objects (inclusive bounds; either may be omitted). Values OR within the filter, AND across filters."
  },
  "headquarters_locations": {
   "type": "array",
   "description": "Filter: headquarters locations. Array of string values. Values OR within the filter, AND across filters."
  },
  "professional_network_ids": {
   "type": "array",
   "description": "Filter
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "total": 1284,
  "matches": [
   {
    "name": "Acme Inc",
    "domain": "acme.example"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fullenrich-company-search-f3f22b66/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fullenrich.agentscore.com](https://www.zero.xyz/host/fullenrich.agentscore.com/llms.txt)