# TradepilotUSA Text Classification

> TradepilotUSA Text Classification 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-30).

Classifies a provided source text into a category and subcategory with rationale, evidence gaps, and a summary, optionally guided by a brief and target audience.

## Facts

- Endpoint: POST https://www.tradepilotusa.com/api/agent-commerce/v1/services/text_classification/execute?utm_source=zero.xyz
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tradepilotusa-text-classification-4c849880
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_R6Ifncb6mFlw6yN9yWM7b

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-text-classification-4c849880 -d '<json body>'
```

Example prompt: Can you classify this text for me? It's a description of a local HVAC company's scheduling and service operations — I want to know what category and subcategory it falls into, and whether there are any gaps in the evidence. The brief is 'identify the primary business activity and operational model'.

## When to prefer this

Choose this endpoint when you need structured, reasoned text classification with explicit rationale, assumptions, and evidence gap reporting rather than a simple label. It is well-suited for business operations contexts where auditability and human-review flagging matter. Prefer this over generic NLP APIs when you need subcategory granularity and provenance metadata alongside the classification result.

## Known failure modes

- source_text shorter than 20 characters returns validation error
- source_text exceeding 32,000 characters is rejected
- brief exceeding 500 characters may be truncated or rejected
- ambiguous or very short input may result in low-confidence classifications with requires_human_review set to true
- payment failure via x402 protocol returns 402 Payment Required before processing begins
- malformed JSON body returns 400 Bad Request

## How this service works

Classify supplied text using supplied labels and definitions, with rationale, uncertainty, and an unknown category. Uses buyer-supplied information only; no external research or outbound actions. Returns a draft for human review.

## Output

Returns a JSON object containing the classification task name, a summary of the source text, a detailed artifact with category and subcategory labels plus rationale, provenance metadata (source, timestamp, whether external research was done), a request ID, a list of assumptions made, identified evidence gaps, 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": "text_classification",
  "summary": "The source text describes a residential door installation company’s consultation and installation operations, highlighting scheduling responsibilities and measurement confirmation. Key operational met",
  "artifact": "Illustrative excerpt from a synthetic provider check:\n## Classification of Source Text\n\n### Classification\n- **Category:** Residential Door Installation Service\n- **Subcategory:** Consultation and Installation Operations\n\n### Rationale\nThe source text describes a company that provides residential entry door installation services in Dallas, indicating the primary business activity. It details consultation scheduling managed by the operations manager and the installation crew's role in confirming measurements before final quotes, which relates to ope",
  "provenance": {
   "source": "buyer_supplied",
   "generated_at": "2026-09-22T14:42:34.252Z",
   "external_research_performed": false
  },
  "request_id": "example_text_classification",
  "assumptions": [
   "The company operates solely in residential entry door installation.",
   "Consultations are a critical step before installation and quoting."
  ],
  "evidence_gaps": [
   "Quantitative data on appointment delay rates.",
   "Final project budget details."
  ],
  "requires_human_review": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tradepilotusa-text-classification-4c849880/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)