{"uid":"cap_ym1CbHQZGoWt-VGLCJ4VY","slug":"ysaere-entity-classify-bd14ccce","name":"Ysaere Entity Classify","description":"Ysaere Classify Lite (wallet) — $0.05 USDC for typed labels (company/person/protocol/…); batch up to 20 names in one request via candidates[]. JSON only. The account name for this same classify is Entity Classify (2 credits).","url":"https://api.ysaere.com/v1/intel/classify?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"target":{"type":"string","description":"Single entity name or URL (use candidates instead to batch)"},"candidates":{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string","description":"Entity string to type"},"context":{"type":"string","description":"Optional surrounding text to disambiguate"}}},"maxItems":20,"minItems":1,"description":"Batch up to 20 entities in one $0.05 call (~$0.0025 each when full). Prefer this for lists."}}},"responseSchema":{"type":"json","example":{"data":{"results":[{"name":"Stripe","type":"company","confidence":0.95},{"name":"Jane Doe","type":"person","confidence":0.9}]},"success":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oepwqixpGWm9wbCmHVZGS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Classifies a named entity (company, person, protocol, etc.) into typed labels with confidence scores","exampleAgentPrompt":"Can you classify 'Stripe' and tell me whether it's a company, person, or protocol — and how confident you are?","exampleUseCases":[{"title":"Enrich CRM contact records","prompt":"I have a bunch of names in my CRM like 'Anthropic', 'Vitalik Buterin', and 'Ethereum' — can you classify each one as a company, person, or protocol so I can tag them properly?"},{"title":"Compliance pipeline entity tagging","prompt":"Before we run a KYB check, I need to know what type of entity 'OpenSea' is — classify it for me so we know whether to treat it as a company or a protocol."},{"title":"News feed entity labeling","prompt":"I'm processing a financial news article and I need to classify the entity 'BlackRock' — is it a company, person, or something else, and what's the confidence level?"}],"resultDescription":"Returns a JSON object with a labels array, where each label contains the entity name, its type (e.g. company, person, protocol), and a confidence score between 0 and 1, wrapped in a success boolean.","failureModes":["Ambiguous entity name may return low confidence scores or multiple conflicting labels","Unknown or very obscure entities may return no labels or low-confidence results","Malformed or empty input string may result in a 400 error","Payment failure or insufficient USDC balance may result in a 402 error"],"whenToPreferThis":"Choose this endpoint when you need fast, typed classification of a named entity into categories like company, person, or protocol with a confidence score — especially in pipelines where entity type disambiguation is needed before deeper checks like KYB verification. Prefer this over general-purpose NLP APIs when you need structured label output with confidence, and over the sibling KYB endpoint when you only need entity type, not a full compliance screen.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T00:34:55.846Z","isFirstParty":false,"canonicalSlug":"ysaere-entity-classify-bd14ccce"}