# TradepilotUSA Search Intent Classifier

> TradepilotUSA Search Intent Classifier 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 keywords or content into likely user search intents (informational, transactional, commercial, navigational) based on supplied site content and a task brief

## Facts

- Endpoint: POST https://www.tradepilotusa.com/api/agent-commerce/v1/services/search_intent/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-search-intent-classifier-30cfd83b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rAFTo3ftFkAWy3fi9Kkmc

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-search-intent-classifier-30cfd83b -d '<json body>'
```

Example prompt: Classify the search intent of these keywords — 'entry door installation Dallas', 'front door cost estimate', 'door installation near me' — based on my site content about residential door installation and weekday consultation services in Dallas. The audience is homeowners looking for contractors.

## When to prefer this

Choose this endpoint when you need keyword search intent classified relative to a specific site's content and audience context, rather than generic intent labels. It is particularly useful for local service businesses, content strategists, and SEO professionals who want intent analysis grounded in their own copy rather than generic industry assumptions. Prefer this over standalone keyword tools when you need structured rationale, uncertainty scoring, and evidence gap reporting alongside the classification.

## Known failure modes

- brief or source_text too short (below minLength) — request rejected with validation error
- source_text exceeds 32,000 character limit — truncation or rejection
- insufficient site content provided to ground classifications — low-confidence or speculative output with evidence gaps flagged
- vague or ambiguous brief — assumptions made and noted in assumptions array
- no external search volume data available — evidence gaps listed, requires_human_review set to true
- payment failure or insufficient USDC balance — 402 response blocking execution

## How this service works

Classify supplied keywords by likely intent with rationale and uncertainty; this is inference, not live search data. Uses buyer-supplied information only; no external research or outbound actions. Returns a draft for human review.

## Output

Returns a structured JSON response containing a keyword intent classification table with intent labels (e.g. Transactional, Informational, Commercial Investigation, Navigational), rationale for each classification, uncertainty levels, a summary narrative, evidence gaps, assumptions made, a provenance block indicating the source and timestamp, 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": "search_intent",
  "summary": "Classified four supplied keywords into likely intents based on supplied fictional site content and keyword phrasing, noting rationale and uncertainty. Highlighted missing evidence such as search volum",
  "artifact": "Illustrative excerpt from a synthetic provider check:\n## Keyword Intent Classification Draft\n\n| Keyword                 | Likely Intent           | Rationale                                                                                          | Uncertainty Level |\n|-------------------------|------------------------|--------------------------------------------------------------------------------------------------|-------------------|\n| entry door installation Dallas | Transactional/Commercial | Indicates a user likely seeking to hire or purchase",
  "provenance": {
   "source": "buyer_supplied",
   "generated_at": "2026-09-22T14:40:43.731Z",
   "external_research_performed": false
  },
  "request_id": "example_search_intent",
  "assumptions": [
   "Keywords reflect typical user queries related to the supplied site services.",
   "Site content accurately describes services offered (residential entry door installation in Dallas and weekday consultati"
  ],
  "evidence_gaps": [
   "User search volume and behavior data for the supplied keywords.",
   "Competitor keyword targeting and ranking information."
  ],
  "requires_human_review": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tradepilotusa-search-intent-classifier-30cfd83b/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)