# agent402.tools Entity Extractor

> agent402.tools Entity Extractor is a paid API for AI agents from agent402.tools, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Extracts and deduplicates emails, URLs, IPv4 addresses, @mentions, and #hashtags from free-form text.

## Facts

- Endpoint: POST https://agent402.tools/api/extract-entities
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-tools-entity-extractor-51554359
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3UX3gk9VEH9REFW1O-D3N

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 agent402-tools-entity-extractor-51554359 -d '<json body>'
```

Example prompt: Pull out all the emails, URLs, IP addresses, @mentions, and hashtags from this text and give me deduplicated lists: 'Contact us at hello@example.com or visit https://example.com. Follow @janedoe and use #launch2024. Server at 192.168.1.1.'

## When to prefer this

Use this endpoint when you need to systematically extract structured contact, link, or social metadata from unstructured text in a single call. It covers five common entity types at once with deduplication built in, making it more efficient than running multiple regex passes or chaining separate NLP tools. Ideal for processing social posts, emails, log files, scraped web content, or any raw text where you need actionable structured data quickly.

## Known failure modes

- Empty or missing 'text' field returns an error or empty results
- Text with no recognizable entities returns empty lists for each category
- Extremely long text may hit payload size limits
- Malformed input schema returns a 400-level error
- Non-Latin scripts or unusual encodings may reduce extraction accuracy

## How this service works

Pull emails, URLs, IPv4s, @mentions, and #hashtags out of free text. Returns deduped lists.

## Output

Returns deduplicated lists of each entity type found in the text: emails, URLs, IPv4 addresses, @mentions, and #hashtags — organized by category with duplicates removed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "text": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "urls": [
   "https://x.com"
  ],
  "emails": [
   "ada@x.com"
  ],
  "hashtags": [
   "#news"
  ],
  "mentions": [
   "@ada"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-tools-entity-extractor-51554359/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)