{"uid":"cap_rAFTo3ftFkAWy3fi9Kkmc","slug":"tradepilotusa-search-intent-classifier-30cfd83b","name":"TradepilotUSA Search Intent Classifier","description":"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.","url":"https://www.tradepilotusa.com/api/agent-commerce/v1/services/search_intent/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":"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}},"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_bAzuMkV2HBAPOfxe-t4am","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":"Classifies keywords or content into likely user search intents (informational, transactional, commercial, navigational) based on supplied site content and a task brief","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"SEO keyword intent audit","prompt":"I have these 10 keywords I'm targeting for my plumbing business in Phoenix: 'emergency plumber Phoenix', 'how to fix leaky faucet', 'plumber cost estimate', 'best plumbers near me', 'DIY pipe repair'. Can you classify each one by search intent — transactional, informational, or navigational — based on my homepage copy? My audience is homeowners with urgent plumbing needs."},{"title":"Content strategy planning for local service","prompt":"I'm writing a content plan for my HVAC company's website. Here's our service page text. Can you analyze these keywords — 'AC tune-up service', 'air conditioning not cooling', 'HVAC maintenance contract', 'how often should I service my AC' — and tell me which are informational vs commercial intent, with rationale? The audience is residential homeowners in Florida."},{"title":"E-commerce landing page keyword targeting","prompt":"We're launching a new landing page for our handmade leather goods shop. Based on our product descriptions below, can you classify the intent behind these search queries: 'buy leather wallet handmade', 'best leather wallet brands', 'how to care for leather wallet', 'personalized leather gifts'? Audience is gift shoppers and leather enthusiasts aged 25-45."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-03T00:39:04.664Z","isFirstParty":false,"canonicalSlug":"tradepilotusa-search-intent-classifier-30cfd83b"}