# JigsawStack Sentiment Classification

> JigsawStack Sentiment Classification is a paid API for AI agents from jigsawstack.withzero.ai, paid per call via MPP, $0.001/call, status unknown (last checked 2026-09-15).

Classifies the sentiment of a given text snippet (e.g. positive, negative, neutral) using AI NLP.

## Facts

- Endpoint: POST https://jigsawstack.withzero.ai/v1/sentiment
- Price: $0.001/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Provider: jigsawstack.withzero.ai
- Website: https://jigsawstack.withzero.ai
- Canonical page: https://www.zero.xyz/c/jigsawstack-withzero-ai-sentiment-131ee7ef
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qt7JOpdM_Ueb_jeFd9m1S

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 jigsawstack-withzero-ai-sentiment-131ee7ef -d '<json body>'
```

Example prompt: Classify the sentiment of this customer review and tell me whether it's positive, negative, or neutral: "The onboarding was smooth but the billing support took forever and left me really frustrated."

## When to prefer this

Choose this endpoint when you need fast, low-cost per-call sentiment classification on individual text snippets without managing your own NLP infrastructure. Ideal for agents processing customer feedback, social media posts, support tickets, or any short text where emotional tone is needed. Best when integrated into a micro-payment-friendly workflow using USDC via MPP/Tempo.

## Known failure modes

- Empty or missing text input returns a 400 validation error
- Text exceeding length limits may be rejected or truncated
- Non-English text may yield lower accuracy or unexpected classification
- Ambiguous or sarcastic text may be misclassified with low confidence
- Network timeout or upstream JigsawStack API unavailability returns a 5xx error
- Insufficient USDC balance for payment results in a payment/authorization failure

## How this service works

Sentiment classification on a text snippet.

## Output

Returns a sentiment classification (e.g. positive, negative, neutral) for the input text, along with a confidence score or probability breakdown indicating how strongly the model associates the text with each sentiment class.

## Example request

```json
{
 "text": "I absolutely loved this product! The quality is excellent and the customer service was incredibly helpful. Highly recommend!"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "text"
 ],
 "properties": {
  "text": {
   "type": "string",
   "description": "The text snippet to classify sentiment on."
  }
 },
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "success",
  "sentiment",
  "_usage",
  "log_id"
 ],
 "properties": {
  "_usage": {
   "type": "object",
   "required": [
    "input_tokens",
    "output_tokens",
    "inference_time_tokens",
    "total_tokens"
   ],
   "properties": {
    "input_tokens": {
     "type": "number"
    },
    "total_tokens": {
     "type": "number"
    },
    "output_tokens": {
     "type": "number"
    },
    "inference_time_tokens": {
     "type": "number"
    }
   }
  },
  "log_id": {
   "type": "string"
  },
  "success": {
   "type": "boolean"
  },
  "sentiment": {
   "type": "object",
   "required": [
    "emotion",
    "sentiment",
    "score",
    "sentences"
   ],
   "properties": {
    "score": {
     "type": "number"
    },
    "emotion": {
     "type": "string"
    },
    "sentences": {
     "type": "array",
     "items": {
      "type": "object",
      "required": [
       "text",
       "emotion",
       "sentiment",
       "score"
      ],
      "properties": {
       "text": {
        "type": "string"
       },
       "score": {
        "type": "number"
       },
       "emotion": {
        "type": "string"
       },
       "sentiment": {
        "type": "string"
       }
      }
     }
    },
    "sentiment": {
     "type": "string"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/jigsawstack-withzero-ai-sentiment-131ee7ef/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from jigsawstack.withzero.ai](https://www.zero.xyz/host/jigsawstack.withzero.ai/llms.txt)