# TradepilotUSA Entity Extraction

> TradepilotUSA Entity Extraction is a paid API for AI agents from www.tradepilotusa.com, paid per call via x402, $0.25/call, status unknown (last checked 2026-10-02).

Extracts structured business entities (organizations, products/services, places, dates/times) from unstructured source text

## Facts

- Endpoint: POST https://www.tradepilotusa.com/api/agent-commerce/v1/services/entity_extraction/execute?utm_source=zero.xyz
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tradepilotusa-entity-extraction-2af989ca
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_F6EHvroDZsUgwjFWLAQ8S

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 tradepilotusa-entity-extraction-2af989ca -d '<json body>'
```

Example prompt: Can you extract all the business entities from this document — pull out any organizations, products, places, and dates you find: 'Acme Roofing provides commercial roof installation in Houston. Consultations are available Monday through Friday. Our next team review is scheduled for October 15th.' The brief is for a B2B lead generation workflow targeting small business owners.

## When to prefer this

Choose this endpoint when you need to extract structured named entities (organizations, services, places, dates) from unstructured business text and want categorized output with evidence citations and confidence signals. Particularly well-suited for business operations contexts such as CRM enrichment, lead intake, vendor analysis, or contract review. Prefer this over generic NLP APIs when you need provenance metadata, assumption logging, and evidence gap reporting alongside the extracted entities.

## Known failure modes

- source_text too short (below 20 characters) returns validation error
- source_text exceeds 32,000 character limit returns 400 error
- brief exceeds 12,000 characters returns validation error
- Ambiguous or low-information source text may produce incomplete entity lists with populated evidence_gaps
- External research is not performed so entities only available outside the supplied text will be missed
- requires_human_review flag set to true when confidence is low

## How this service works

Extract explicitly stated organizations, products, places, dates, and business terms from supplied text, with evidence snippets. Uses buyer-supplied information only; no external research or outbound actions. Returns a draft for human review.

## Output

Returns a structured JSON object with a task label, a plain-language summary of extracted entities, a detailed markdown artifact organizing entities by category (organizations, products/services, places, dates/times) with supporting evidence quotes, provenance metadata, a list of assumptions made, identified evidence gaps, a flag indicating whether human review is recommended, and a unique request ID.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "brief": {
   "type": "string",
   "maxLength": 12000,
   "minLength": 10
  },
  "audience": {
   "type": "string",
   "maxLength": 500
  },
  "source_text": {
   "type": "string",
   "maxLength": 32000,
   "minLength": 20
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "task": "entity_extraction",
  "summary": "Extracted entities include Example Door Company (organization), residential entry door installation (product/service), Dallas (place), consultation availability Monday through Friday (dates/times), an",
  "artifact": "Illustrative excerpt from a synthetic provider check:\n### Extracted Business Information from Source Document\n\n#### Organizations\n- Example Door Company\n  - Evidence: \"Example Door Company provides residential entry door installation in Dallas.\"\n\n#### Products / Services\n- Residential entry door installation\n  - Evidence: \"Example Door Company provides residential entry door installation in Dallas.\"\n\n#### Places\n- Dallas\n  - Evidence: \"Example Door Company provides residential entry door installation in Dallas.\"\n\n#### Dates / Times\n- Consultations ",
  "provenance": {
   "source": "buyer_supplied",
   "generated_at": "2026-09-22T14:42:31.213Z",
   "external_research_performed": false
  },
  "request_id": "example_entity_extraction",
  "assumptions": [
   "\"Consultations\" refers to customer meetings related to door installation.",
   "The \"next meeting\" involves internal staff reviewing operational metrics."
  ],
  "evidence_gaps": [
   "Exact date and time of the next meeting.",
   "Specific delay rate statistics."
  ],
  "requires_human_review": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tradepilotusa-entity-extraction-2af989ca/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.tradepilotusa.com](https://www.zero.xyz/host/www.tradepilotusa.com/llms.txt)