# SiteCheck Text Classifier

> SiteCheck Text Classifier is a paid API for AI agents from api.sitecheck-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-28).

Classifies one or more text strings against a user-supplied set of labels, returning a confidence score, reason, and excerpt for each result

## Facts

- Endpoint: POST https://api.sitecheck-api.workers.dev/api/classify?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sitecheck-text-classifier-ca919dab
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zez2sk7mLcPXGMFTe1D1s

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability sitecheck-text-classifier-ca919dab -d '<json body>'
```

Example prompt: Classify this customer review as either 'complaint', 'praise', or 'neutral' and tell me how confident you are: 'The package arrived three days late and nobody from support responded to my emails.'

## When to prefer this

Choose this endpoint when you need zero-shot text classification with confidence scores and reasoning against a custom label set you define at call time, without training a model. Ideal for dynamic label sets that change per request, or when you want explainability (reason + excerpt) alongside the label. Prefer over embedding-based classifiers when you want human-readable rationale, and over fine-tuned models when labels are ad hoc or low-volume.

## Known failure modes

- Fewer than 2 or more than 20 labels provided — validation error
- More than 20 texts submitted at once — exceeds batch limit
- Empty or missing text/texts fields — returns error or empty results
- Ambiguous or overlapping labels may produce lower confidence scores
- Model unavailability on Workers AI falls back to Groq; if both fail, returns 5xx
- Payment not included or insufficient — x402 payment required error

## How this service works

Labels up to 20 texts with 2 to 20 labels you choose, with a confidence from 0 to 1 and a one-line reason per text. One label per text, or several with multi true. Uses the chat model with JSON output; labels are as good as the model's reading of them.

## Output

A JSON object containing the model name used, the data source, and a results array where each item includes the text index, an array of matched labels with confidence scores, a natural-language reason for the classification, and an excerpt from the original text. Also includes a checkedAt ISO timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "text": {
   "type": "string",
   "description": "One text (or texts)"
  },
  "multi": {
   "type": "boolean",
   "description": "true when a text may take several labels"
  },
  "texts": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Up to 20 texts"
  },
  "labels": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "2 to 20 different labels"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "model": "@cf/meta/llama-3.3-70b-instruct-fp8-fast",
  "source": "chat model (Workers AI, Groq fallback), JSON output",
  "results": [
   {
    "index": 0,
    "labels": [
     {
      "label": "complaint",
      "confidence": 0.95
     }
    ],
    "reason": "Reports damage and no support reply.",
    "excerpt": "The package arrived broken and support never answered."
   },
   {
    "index": 1,
    "labels": [
     {
      "label": "praise",
      "confidence": 0.93
     }
    ],
    "reason": "Thanks the team for a fast fix.",
    "excerpt": "Great service, the team fixed it in an hour."
   }
  ],
  "checkedAt": "2026-10-14T07:05:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sitecheck-text-classifier-ca919dab/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.sitecheck-api.workers.dev](https://www.zero.xyz/host/api.sitecheck-api.workers.dev/llms.txt)
