# DopamineDesk Bulk Sentiment Analysis API

> DopamineDesk Bulk Sentiment Analysis API is a paid API for AI agents from ai-data-marketplace-1042299154756.us-central1.run.app, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Analyzes sentiment of multiple text strings in a single call, returning per-text sentiment label, score, and aggregate statistics.

## Facts

- Endpoint: GET https://ai-data-marketplace-1042299154756.us-central1.run.app/api/v1/sentiment_bulk
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/dopaminedesk-bulk-sentiment-analysis-api-c8e414ab
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_59M3fzU87TAMmgFmBVGb0

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 dopaminedesk-bulk-sentiment-analysis-api-c8e414ab
```

Example prompt: Can you run sentiment analysis on all of these customer reviews at once and tell me how many are positive, negative, or neutral, plus the average score: 'Love this app!', 'Crashes on startup.', 'It's okay, nothing special.'

## When to prefer this

Choose this endpoint when you need to analyze sentiment across multiple texts in a single API call rather than making repeated single-text requests. It is ideal for batch processing customer reviews, social media posts, survey responses, or any scenario where you have a list of texts and need both per-item sentiment scores and an aggregate summary in one shot. Prefer it over single-text sentiment APIs when cost-per-call efficiency and aggregate statistics matter.

## Known failure modes

- Empty texts array returns an error or empty results
- Texts array containing non-string items may cause parsing errors
- Very long individual texts may be truncated or rejected
- Rate limiting or payment failure via x402 USDC settlement may block the request
- Network timeout for very large batches

## How this service works

Score up to 100 texts with a transparent deterministic positive and negative keyword lexicon.

## Output

Returns a JSON object with a 'results' array where each entry contains the original text, a sentiment label ('positive', 'negative', or 'neutral'), and a numeric score (approximately -1.0 to 1.0). Also includes an 'aggregate' object with counts per sentiment category and the average score across all inputs.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "texts"
     ],
     "properties": {
      "texts": {
       "type": "array",
       "items": {
        "type": "string"
       },
       "description": "Array of text strings to analyze."
      }
     },
     "additionalProperties": true
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "success",
      "engine",
      "count",
      "average_score",
      "results",
      "marketplace_metadata"
     ],
     "properties": {
      "count": {
       "type": "integer"
      },
      "engine": {
       "type": "string"
      },
      "results": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "text",
         "score",
         "label"
        ],
        "properties": {
         "text": {
          "type": "string"
         },
         "label": {
          "type": "string"
         },
         "score": {
          "type": "integer"
         }
        },
        "additionalProperties": true
       }
      },
      "success": {
       "type": "boolean"
      },
      "average_score": {
       "type": "integer"
      },
      "marketplace_metadata": {
       "type": "object",
       "required": [
        "data_mode",
        "billable",
        "availability",
        "source"
       ],
       "properties": {
        "source": {
         "type": "string"
        },
        "billable": {
         "type": "boolean"
        },
        "data_mode": {
         "type": "string"
        },
        "availability": {
         "type": "string"
        }
       },
       "additionalProperties": true
      }
     },
     "additionalProperties": true
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 3,
  "engine": "transparent_keyword_lexicon_v1",
  "results": [
   {
    "text": "Love this app!",
    "label": "NEUTRAL",
    "score": 0
   },
   {
    "text": "Crashes on startup.",
    "label": "NEUTRAL",
    "score": 0
   }
  ],
  "success": true,
  "average_score": 0,
  "marketplace_metadata": {
   "source": "deterministic keyword lexicon",
   "billable": true,
   "data_mode": "computed_service",
   "availability": "operational"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/dopaminedesk-bulk-sentiment-analysis-api-c8e414ab/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ai-data-marketplace-1042299154756.us-central1.run.app](https://www.zero.xyz/host/ai-data-marketplace-1042299154756.us-central1.run.app/llms.txt)