# TradepilotUSA Label Taxonomy Generator

> TradepilotUSA Label Taxonomy Generator 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).

Generates a clear, non-overlapping label taxonomy from a source text and optional brief and audience description

## Facts

- Endpoint: POST https://www.tradepilotusa.com/api/agent-commerce/v1/services/label_taxonomy/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-label-taxonomy-generator-72f2ba29
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_e0nVg1BlOr4oqShysK59y

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-label-taxonomy-generator-72f2ba29 -d '<json body>'
```

Example prompt: I need a clean, non-overlapping label taxonomy for my residential HVAC service business — here's a sample of about 50 customer interaction records and service notes to work from. The audience is our internal ops team who will use these labels for CRM tagging.

## When to prefer this

Choose this endpoint when you need to automatically derive a structured, non-overlapping label or tagging taxonomy from an existing body of text — particularly useful before building classifiers, organizing CRM data, or standardizing content categories. It is distinct from simple keyword extraction or sentiment analysis; it produces a full taxonomy with definitions and example rules, not just tags. Prefer it over manual taxonomy design when you have representative source text available and need a consistent, defensible label schema fast.

## Known failure modes

- source_text too short (below 20 characters) returns validation error
- brief exceeds 12,000 character limit causes rejection
- source_text exceeds 32,000 character limit causes rejection
- vague or contradictory source text may produce overlapping or poorly defined labels
- missing audience may result in taxonomy not tailored to intended users
- payment failure or insufficient USDC balance returns 402

## How this service works

Design a non-overlapping label taxonomy from supplied business examples, with definitions and ambiguous-case rules. Uses buyer-supplied information only; no external research or outbound actions. Returns a draft for human review.

## Output

Returns a structured JSON object containing the task name, a summary of the taxonomy, a detailed artifact with labeled categories and definitions including example phrases and ambiguous-case rules, a provenance block indicating data source and generation timestamp, a unique 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": "label_taxonomy",
  "summary": "A clear, non-overlapping label taxonomy was designed for the residential door installation business using only the supplied fictional examples. Five labels cover service offerings, consultation schedu",
  "artifact": "Illustrative excerpt from a synthetic provider check:\n## Non-Overlapping Label Taxonomy for Residential Door Installation Business\n\n### Labels and Definitions\n\n1. **Service Offering**\n   - Definition: Describes the core business services provided to customers.\n   - Example: \"Residential entry door installation in Dallas.\"\n\n2. **Consultation Scheduling**\n   - Definition: Activities and responsibilities related to arranging customer consultations.\n   - Example: \"Consultations are available Monday through Friday.\"\n   - Ambiguous Case Rule: If scheduli",
  "provenance": {
   "source": "buyer_supplied",
   "generated_at": "2026-09-22T14:42:40.842Z",
   "external_research_performed": false
  },
  "request_id": "example_label_taxonomy",
  "assumptions": [
   "The business examples provided are representative of the main operational areas.",
   "Consultation scheduling is distinct from installation activities."
  ],
  "evidence_gaps": [
   "Actual delay rates and final project budget figures are not supplied.",
   "Detailed installation process steps beyond measurement confirmation are missing."
  ],
  "requires_human_review": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tradepilotusa-label-taxonomy-generator-72f2ba29/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)