# TradepilotUSA Keyword-to-Page Mapping

> TradepilotUSA Keyword-to-Page Mapping 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).

Maps a list of keywords to existing website URLs while detecting cannibalization conflicts and identifying content gaps that suggest new page opportunities.

## Facts

- Endpoint: POST https://www.tradepilotusa.com/api/agent-commerce/v1/services/keyword_page_map/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-keyword-to-page-mapping-3a2b8190
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NgTXDdarM8u74mTqjhZIH

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-to-page-mapping-3a2b8190 -d '<json body>'
```

Example prompt: I have a list of keywords for my door installation business along with our existing pages at /doors, /consultations, and /gallery — can you map each keyword to the right page, flag any cannibalization issues, and suggest any new pages we might need for gaps?

## When to prefer this

Choose this endpoint when you need to assign specific keywords to specific URLs across an existing or planned site architecture, especially when cannibalization risk is a concern. It is particularly valuable when you have a mix of existing pages and a keyword list and need structured recommendations rather than a freeform content brief. Prefer it over generic content generation tools when the primary goal is SEO site structure planning rather than writing copy.

## Known failure modes

- brief or source_text too short (below minLength) returns validation error
- source_text exceeds 32,000 characters causing rejection
- vague or ambiguous brief leads to low-confidence mappings with many assumptions listed
- no existing URLs provided in source_text results in all keywords mapped to proposed new pages
- insufficient keyword diversity in source_text produces sparse output with limited gap analysis

## How this service works

Map supplied keywords to supplied or proposed pages, flag cannibalization, and separate existing from proposed URLs. Uses buyer-supplied information only; no external research or outbound actions. Returns a draft for human review.

## Output

Returns a structured keyword-to-page mapping showing which existing URLs should target which keywords, a list of cannibalization conflicts where multiple pages compete for the same term, proposed new URL slugs for content gaps, a plain-language summary, key assumptions made, 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": "keyword_page_map",
  "summary": "Mapped supplied keywords to existing URLs without cannibalization; identified a content gap in door measurement preparation suggesting a new proposed page. Existing URLs are /doors and /consultations;",
  "artifact": "Illustrative excerpt from a synthetic provider check:\n## Keyword to Page Mapping and Cannibalization Analysis\n\n### Existing URLs and Keyword Mapping\n- **https://example.com/doors**\n  - Keywords:\n    - \"entry door installation Dallas\"\n    - \"residential entry doors\"\n\n- **https://example.com/consultations**\n  - Keywords:\n    - \"door consultation Dallas\"\n    - \"schedule door consultation\"\n\n### Proposed URL Suggestions\n- **https://example.com/measurement-preparation** (Proposed)\n  - Keywords:\n    - \"door measurement preparation\"\n    - \"how to measure d",
  "provenance": {
   "source": "buyer_supplied",
   "generated_at": "2026-09-22T14:40:48.362Z",
   "external_research_performed": false
  },
  "request_id": "example_keyword_page_map",
  "assumptions": [
   "The supplied keywords are comprehensive for the current business focus.",
   "The competitor content excerpt is accurate and representative of competitor coverage."
  ],
  "evidence_gaps": [
   "Complete keyword list beyond the four supplied keywords.",
   "Full competitor content and URLs for detailed gap analysis."
  ],
  "requires_human_review": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tradepilotusa-keyword-to-page-mapping-3a2b8190/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)