{"uid":"cap_NgTXDdarM8u74mTqjhZIH","slug":"tradepilotusa-keyword-to-page-mapping-3a2b8190","name":"TradepilotUSA Keyword-to-Page Mapping","description":"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.","url":"https://www.tradepilotusa.com/api/agent-commerce/v1/services/keyword_page_map/execute?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"brief":{"type":"string","maxLength":12000,"minLength":10},"audience":{"type":"string","maxLength":500},"source_text":{"type":"string","maxLength":32000,"minLength":20}}},"responseSchema":{"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}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KW1QYbBEi_sZer_9s9ein","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Maps a list of keywords to existing website URLs while detecting cannibalization conflicts and identifying content gaps that suggest new page opportunities.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"SEO audit for home services site","prompt":"Here's a list of 30 keywords for my HVAC company and a dump of our current site pages — can you map each keyword to the best existing URL, call out any pages that are competing with each other, and tell me what new pages I should create to cover the gaps?"},{"title":"Content planning for e-commerce launch","prompt":"We're launching a new furniture store and I have 50 target keywords plus competitor page excerpts as source text — map those keywords to our planned URLs like /sofas, /dining, and /bedroom, flag any cannibalization, and recommend additional pages we're missing."},{"title":"Blog restructure for SaaS company","prompt":"Our SaaS blog has gotten messy and several posts seem to rank for the same terms. Here's a brief describing our audience and a paste of our post titles and URLs — can you assign each keyword to the most appropriate page and identify where we're cannibalizing ourselves?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:45:01.555Z","isFirstParty":false,"canonicalSlug":"tradepilotusa-keyword-to-page-mapping-3a2b8190"}