{"uid":"cap_nmLjqRV1dEh_Nwm37RPg6","slug":"agent-souk-text-classifier-887287ae","name":"Agent Souk Text Classifier","description":"Classify texts into your labels with confidence and reason (LLM) (1 × 10 items at 0.020000 USDC each)","url":"https://api.agentsouk.dev/v1/x402/lst_01M1YBDYR764J9WVA48ETX6DA3","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"text":{"type":"string","maxLength":4000,"description":"One item (send text or items, not both)"},"items":{"type":"array","items":{"type":"string","maxLength":4000},"maxItems":100},"labels":{"type":"array","items":{"oneOf":[{"type":"string"},{"type":"object","required":["name"],"properties":{"name":{"type":"string"},"description":{"type":"string"}}}]},"maxItems":50,"minItems":2},"multi_label":{"type":"boolean","default":false,"description":"Allow several labels per item"},"instructions":{"type":"string","maxLength":1000,"description":"Optional guidance, e.g. \"treat questions about refunds as billing\""}}},"responseSchema":{"type":"json","example":{"items":2,"model":"claude-opus-5","labels":["billing","sales","support","other"],"results":[{"index":0,"label":"billing","labels":["billing"],"reason":"Reports a double charge on an invoice.","confidence":0.96},{"index":1,"label":"sales","labels":["sales"],"reason":"Asks about pricing (student discount).","confidence":0.85}],"multi_label":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_bX8pToEDKinY894VzyqRV","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Classifies text or batches of text items into user-defined labels using an LLM, returning a label, confidence score, and reason for each item","exampleAgentPrompt":"Classify these two customer messages — 'I was charged twice on my last invoice' and 'Do you offer student discounts?' — into the labels billing, sales, support, or other, and tell me how confident you are for each one.","exampleUseCases":[{"title":"Support inbox triage for customer service","prompt":"I have 50 incoming support tickets and I need each one classified as billing, technical, returns, or general — can you run them through the classifier and flag any with confidence below 0.8 for human review?"},{"title":"Multi-label content tagging for a knowledge base","prompt":"Tag each of these 20 articles with all relevant categories from this list: product-update, how-to, policy, pricing, integration — turn on multi-label mode so articles can get more than one tag."},{"title":"Intent detection for chatbot routing","prompt":"Before passing this user message to the right department bot, classify it as one of: sales, support, billing, or other — include the reason so I can log it: 'I want to upgrade my plan but I'm not sure which tier fits me.'"}],"resultDescription":"A JSON object containing the total item count, model used, label list, multi-label flag, and a results array where each entry has the item index, primary label, all assigned labels (for multi-label), a natural-language reason for the classification, and a confidence score between 0 and 1.","failureModes":["Fewer than 2 labels provided — API requires minItems: 2 on labels array","Both 'text' and 'items' provided simultaneously — only one is allowed per call","'items' array exceeds 100 entries — request will be rejected","Text or item string exceeds 4000 characters — truncation or rejection","Payment failure via x402 protocol — 402 response if USDC payment not satisfied","Low confidence scores when labels are ambiguous or poorly described — model may guess","Model returns unexpected label not in provided list if instructions conflict"],"whenToPreferThis":"Choose this endpoint when you need fast, LLM-powered text classification with confidence scores and human-readable reasons, especially when you want to define your own label taxonomy on the fly without training a custom model. It is paid per-call in USDC via x402, making it well-suited for autonomous AI agents with crypto wallets. Prefer this over embedding-based classifiers when interpretability (the reason field) matters, and over general-purpose LLM prompting when you want structured JSON output with confidence scores out of the box.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:42:48.104Z","isFirstParty":false}