{"uid":"cap_R6Ifncb6mFlw6yN9yWM7b","slug":"tradepilotusa-text-classification-4c849880","name":"TradepilotUSA Text Classification","description":"Classify supplied text using supplied labels and definitions, with rationale, uncertainty, and an unknown category. 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/text_classification/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":"text_classification","summary":"The source text describes a residential door installation company’s consultation and installation operations, highlighting scheduling responsibilities and measurement confirmation. Key operational met","artifact":"Illustrative excerpt from a synthetic provider check:\n## Classification of Source Text\n\n### Classification\n- **Category:** Residential Door Installation Service\n- **Subcategory:** Consultation and Installation Operations\n\n### Rationale\nThe source text describes a company that provides residential entry door installation services in Dallas, indicating the primary business activity. It details consultation scheduling managed by the operations manager and the installation crew's role in confirming measurements before final quotes, which relates to ope","provenance":{"source":"buyer_supplied","generated_at":"2026-09-22T14:42:34.252Z","external_research_performed":false},"request_id":"example_text_classification","assumptions":["The company operates solely in residential entry door installation.","Consultations are a critical step before installation and quoting."],"evidence_gaps":["Quantitative data on appointment delay rates.","Final project budget details."],"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_xi5QtZg47Nk4zcX_RfRfS","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 a provided source text into a category and subcategory with rationale, evidence gaps, and a summary, optionally guided by a brief and target audience.","exampleAgentPrompt":"Can you classify this text for me? It's a description of a local HVAC company's scheduling and service operations — I want to know what category and subcategory it falls into, and whether there are any gaps in the evidence. The brief is 'identify the primary business activity and operational model'.","exampleUseCases":[{"title":"Categorize incoming business proposals","prompt":"I have a 2-page business proposal text I need classified — can you run it through text classification with the brief 'identify the industry and service type' and audience 'internal procurement team', and tell me what category it falls under and what assumptions are being made?"},{"title":"Label customer support tickets by topic","prompt":"Here's a customer support message from our inbox: 'The technician arrived late and didn't complete the repair.' Classify it by category — I want to know if it's a service quality issue, scheduling complaint, or something else, and flag it for human review if it's ambiguous."},{"title":"Identify sector of a scraped company description","prompt":"I scraped this 'About Us' text from a contractor's website — can you classify it so I know what trade or service sector they operate in? Use the brief 'determine primary service offering and geographic scope'."}],"resultDescription":"Returns a JSON object containing the classification task name, a summary of the source text, a detailed artifact with category and subcategory labels plus rationale, provenance metadata (source, timestamp, whether external research was done), a request ID, a list of assumptions made, identified evidence gaps, and a flag indicating whether human review is recommended.","failureModes":["source_text shorter than 20 characters returns validation error","source_text exceeding 32,000 characters is rejected","brief exceeding 500 characters may be truncated or rejected","ambiguous or very short input may result in low-confidence classifications with requires_human_review set to true","payment failure via x402 protocol returns 402 Payment Required before processing begins","malformed JSON body returns 400 Bad Request"],"whenToPreferThis":"Choose this endpoint when you need structured, reasoned text classification with explicit rationale, assumptions, and evidence gap reporting rather than a simple label. It is well-suited for business operations contexts where auditability and human-review flagging matter. Prefer this over generic NLP APIs when you need subcategory granularity and provenance metadata alongside the classification result.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-03T00:32:52.460Z","isFirstParty":false,"canonicalSlug":"tradepilotusa-text-classification-4c849880"}