# TradepilotUSA Structured Extraction

> TradepilotUSA Structured 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-09-29).

Extracts structured, organized information from unstructured source text based on a provided brief and target audience.

## Facts

- Endpoint: POST https://www.tradepilotusa.com/api/agent-commerce/v1/services/structured_extraction/execute?utm_source=zero.xyz
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tradepilotusa-structured-extraction-c45c1db9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_m9sMARjonUFPkhLNurDAG

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-structured-extraction-c45c1db9 -d '<json body>'
```

Example prompt: I have a long block of raw notes from a vendor about their service offerings — can you extract and structure the key details like company info, service area, scheduling, and operational notes into a clean markdown report? The audience is our internal procurement team and the brief is to identify service capabilities and any gaps.

## When to prefer this

Choose this endpoint when you need to take long-form, unstructured business text and extract it into organized, structured sections with explicit assumptions and evidence gaps identified. It is particularly suited for business operations contexts — vendor documents, sales notes, onboarding submissions, or operational briefs — where the output needs to be audience-targeted and audit-ready with provenance tracking. Prefer this over generic NLP APIs when you need a structured artifact with explicit gap analysis rather than just a summary or classification.

## Known failure modes

- source_text too short (below 20 characters) returns validation error
- brief too short (below 10 characters) returns validation error
- source_text exceeds 32,000 character limit returns 400 error
- brief exceeds 12,000 character limit returns 400 error
- ambiguous or low-context source_text may produce low-confidence output with many evidence_gaps
- payment failure via x402 returns 402 status with no extraction performed

## How this service works

Extract requested fields from supplied text into a clearly structured artifact; use null for missing data. Uses buyer-supplied information only; no external research or outbound actions. Returns a draft for human review.

## Output

Returns a JSON object containing a structured summary of the source text, a markdown-formatted artifact with organized sections, a list of assumptions made during extraction, identified evidence gaps, provenance metadata (source, timestamp, whether external research was used), a request ID, and a flag indicating whether human review is recommended.

## 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": "structured_extraction",
  "summary": "Example Door Company provides residential entry door installation in Dallas with consultations available Monday through Friday. The operations manager handles scheduling, and the installation crew con",
  "artifact": "Illustrative excerpt from a synthetic provider check:\n## Business Draft: Residential Entry Door Installation Service\n\n### Company Overview\n- **Company Name:** Example Door Company\n- **Service Provided:** Residential entry door installation\n- **Service Area:** Dallas\n\n### Consultation Details\n- **Availability:** Monday through Friday\n- **Scheduling Owner:** Operations Manager\n\n### Installation Process\n- **Measurement Confirmation:** Installation crew confirms measurements before providing a final quote\n\n### Current Operational Notes\n- **Upcoming Mee",
  "provenance": {
   "source": "buyer_supplied",
   "generated_at": "2026-09-22T14:42:29.861Z",
   "external_research_performed": false
  },
  "request_id": "example_structured_extraction",
  "assumptions": [
   "The operations manager has full authority over consultation scheduling.",
   "Measurement confirmation by the installation crew is a standard step before quoting."
  ],
  "evidence_gaps": [
   "Specific current delay rates for appointments.",
   "Final project budget details."
  ],
  "requires_human_review": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tradepilotusa-structured-extraction-c45c1db9/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)