# TradepilotUSA Keyword Cluster Executor

> TradepilotUSA Keyword Cluster Executor 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).

Groups a supplied list of keywords or source text into intent-based clusters with summaries, assumptions, and evidence gaps

## Facts

- Endpoint: POST https://www.tradepilotusa.com/api/agent-commerce/v1/services/keyword_cluster/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-keyword-cluster-executor-99c062b6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YYleOknpsiarE2Ml-7DIX

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-keyword-cluster-executor-99c062b6 -d '<json body>'
```

Example prompt: Can you group these keywords into intent clusters for me? My audience is small business owners in Dallas looking for door installation services, and here's the full list: 'entry door installation Dallas, residential entry doors, front door replacement, door consultation Dallas, best entry doors for homes'.

## When to prefer this

Choose this endpoint when you need to semantically group a list of keywords or content into intent-based clusters without requiring live search volume data. It is ideal for SEO content planning, PPC ad group organization, or pre-analysis of competitor keyword sets where the goal is thematic segmentation and intent classification from text alone, rather than real-time search metrics.

## Known failure modes

- Source text or brief below minimum length (10 chars for brief, 20 for source_text) returns validation error
- Exceeding maxLength limits (12000 for brief, 32000 for source_text) causes rejection
- Ambiguous or extremely short keyword lists may produce low-confidence clusters with many assumptions
- No external search volume or ranking data is used — clustering is based solely on supplied text
- requires_human_review flag may be true for complex or ambiguous keyword sets

## How this service works

Group supplied keywords by intent and topic, explain ambiguous groupings, and do not invent search volume. Uses buyer-supplied information only; no external research or outbound actions. Returns a draft for human review.

## Output

Returns a JSON object containing a task identifier, a natural-language summary of the keyword clusters, a detailed artifact with named groups and per-group intent explanations, provenance metadata (source, timestamp, whether external research was performed), a list of assumptions made during clustering, identified evidence gaps (e.g. missing search volume data), 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": "keyword_cluster",
  "summary": "The supplied keywords group into two main intents: entry door installation services in Dallas and door consultation scheduling. Ambiguities include the broad term \"residential entry doors\" and the loc",
  "artifact": "Illustrative excerpt from a synthetic provider check:\n## Keyword Grouping by Intent and Topic\n\n### Group 1: Entry Door Installation Services\n- entry door installation Dallas\n- residential entry doors\n\n**Intent:** These keywords focus on the service of installing residential entry doors in Dallas. \"entry door installation Dallas\" is location-specific and transactional, indicating users looking to hire installation services. \"residential entry doors\" is broader and could include research or product consideration.\n\n### Group 2: Door Consultation Sched",
  "provenance": {
   "source": "buyer_supplied",
   "generated_at": "2026-09-22T14:40:41.125Z",
   "external_research_performed": false
  },
  "request_id": "example_keyword_cluster",
  "assumptions": [
   "The site focuses on residential entry door installation in Dallas based on the supplied URLs and descriptions.",
   "Keywords without explicit location modifiers are assumed to relate to Dallas due to site context."
  ],
  "evidence_gaps": [
   "Search volume and ranking data for the supplied keywords.",
   "Customer ratings, reviews, or outcome data related to the services."
  ],
  "requires_human_review": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tradepilotusa-keyword-cluster-executor-99c062b6/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)