{"uid":"cap_YYleOknpsiarE2Ml-7DIX","slug":"tradepilotusa-keyword-cluster-executor-99c062b6","name":"TradepilotUSA Keyword Cluster Executor","description":"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.","url":"https://www.tradepilotusa.com/api/agent-commerce/v1/services/keyword_cluster/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_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}},"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_uVuGf6PFsw2U87Nl7kZ2r","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":"Groups a supplied list of keywords or source text into intent-based clusters with summaries, assumptions, and evidence gaps","exampleAgentPrompt":"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'.","exampleUseCases":[{"title":"SEO content pillar planning","prompt":"I have a big list of keywords I want to target on my site — can you cluster them into topic groups by search intent so I can build content pillars around each one? My audience is homeowners in Phoenix looking for HVAC services, and here are the 30 keywords: 'AC repair Phoenix, air conditioner replacement, emergency HVAC service, HVAC tune-up, best AC units for homes...'"},{"title":"PPC ad group segmentation","prompt":"I'm setting up Google Ads and need to organize these keywords into tight ad groups by intent. My audience is local restaurant owners and the brief is: we want to separate informational queries from transactional ones. Here are the keywords: 'restaurant POS system, best POS for restaurants, buy restaurant software, POS system pricing, restaurant billing software.'"},{"title":"Competitor gap keyword clustering","prompt":"I've pulled a big set of keywords from a competitor content audit and I want to cluster them by topic and intent before deciding which ones to go after first. The audience is e-commerce fashion shoppers and the source text includes all the keywords and page titles I scraped. Can you group them and flag any ambiguous ones?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-03T00:43:11.585Z","isFirstParty":false,"canonicalSlug":"tradepilotusa-keyword-cluster-executor-99c062b6"}