# Agent Extraction API – Named Entity Extraction

> Agent Extraction API – Named Entity Extraction is a paid API for AI agents from freetier-agent-api.pages.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-11-01).

Extracts named entities (people, organizations, locations, dates, money amounts, products) plus emails and URLs from input text up to 6,000 characters.

## Facts

- Endpoint: GET https://freetier-agent-api.pages.dev/api/entity-extract?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-extraction-api-named-entity-extraction-aaa6b35b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Ya-EsftaWjGcgXI0Rh8Oa

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 agent-extraction-api-named-entity-extraction-aaa6b35b
```

Example prompt: Can you pull out all the people, organizations, locations, dates, and money amounts from this text: 'Jane Doe signed a $2 million deal with Acme Corp in Berlin on 3 March 2026.'?

## When to prefer this

Choose this endpoint when you need fast, lightweight named entity recognition from short-to-medium text blobs without running your own NLP pipeline. It's ideal for agents that need to pull structured entity data (people, orgs, locations, dates, money, products, emails, URLs) from unstructured text in a single API call at low cost ($0.005 USDC). Prefer alternatives if you need entity extraction from very long documents (>6,000 chars), need relationship extraction, or require higher-accuracy large-model NER.

## Known failure modes

- Text exceeds 6,000 character limit — request may be rejected or truncated
- No entities found — all arrays return empty
- Ambiguous entities may be missed or miscategorized (e.g. a person's name mistaken for a product)
- Payment failure via x402 protocol if USDC balance is insufficient
- Regex-based email/URL extraction may miss malformed or unusual formats

## How this service works

Invoice-to-JSON, on-chain tools (transaction explainer + payment check, wallet profile, contract ABI, ERC-20 token risk), company contacts and web-to-RAG for AI agents. Pay per call with x402 (USDC on Base). No signup, no API key.

## Output

A JSON object with arrays for each entity type: people, organizations, locations, dates, money, products, emails, and urls. Each array contains strings of the literal text spans found in the input. All AI-extracted entities are verified to literally appear in the source text.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "text"
     ],
     "properties": {
      "text": {
       "type": "string",
       "description": "input text"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "urls": [],
  "dates": [
   "3 March 2026"
  ],
  "money": [
   "$2 million"
  ],
  "emails": [],
  "people": [
   "Jane Doe"
  ],
  "products": [],
  "locations": [
   "Berlin"
  ],
  "organizations": [
   "Acme Corp",
   "Globex"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-extraction-api-named-entity-extraction-aaa6b35b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from freetier-agent-api.pages.dev](https://www.zero.xyz/host/freetier-agent-api.pages.dev/llms.txt)
