# x402 AgentUtility Social Sentiment API

> x402 AgentUtility Social Sentiment API is a paid API for AI agents from x402.agentutility.ai, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-18).

Searches recent public X/Twitter posts for a query and returns aggregate sentiment scores, per-tweet sentiment labels, sentiment distribution, and engagement metrics

## Facts

- Endpoint: POST https://x402.agentutility.ai/social-sentiment?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-agentutility-social-sentiment-api-74e9166b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_i2uwiWqMmQMJYzYLrzMN7

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 x402-agentutility-social-sentiment-api-74e9166b -d '<json body>'
```

Example prompt: Search Twitter right now for sentiment around 'Solana ETF' and give me the aggregate sentiment score, how positive vs negative the posts are, and the average engagement — I want to know if the market narrative is bullish or bearish.

## When to prefer this

Choose this endpoint when you need real-time Twitter/X social sentiment for brands, crypto tokens, topics, or market narratives with structured aggregate output (score + distribution + engagement). Prefer it over generic web search when you need quantified sentiment rather than raw post content, and over historical analytics tools when you need recency (recent posts). Best for crypto market intelligence, brand monitoring, and launch sentiment checks where X is the primary signal source.

## Known failure modes

- Invalid or missing X_BEARER_TOKEN returns authentication error
- Query returns zero matching tweets (low-volume topics), resulting in empty results
- Rate limit exceeded on X API v2 recent search tier
- Ambiguous or overly broad queries may yield noisy sentiment results
- Payment failure via x402/USDC if wallet balance is insufficient

## How this service works

Social sentiment API / Twitter sentiment API / X sentiment search for brands, tokens, topics, launches, and market narratives. Searches recent public posts and returns aggregate sentiment, tweet-level labels, distribution, average score, and public engagement metrics. Read-only X API v2 recent search; requires X_BEARER_TOKEN.

## Output

Returns aggregate sentiment score, distribution breakdown (positive/neutral/negative percentages), per-tweet sentiment labels, average sentiment score, and public engagement metrics (likes, retweets, replies) for the matched recent X/Twitter posts.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [
      "query"
     ],
     "properties": {
      "query": {
       "type": "string",
       "description": "X recent-search query."
      },
      "language": {
       "type": "string",
       "description": "Optional two-letter language filter."
      },
      "max_results": {
       "type": "number",
       "description": "Number of recent posts to fetch, clamped to 10-50."
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "distribution": {
       "type": "object",
       "properties": {
        "neutral": {
         "type": "integer"
        },
        "negative": {
         "type": "integer"
        },
        "positive": {
         "type": "integer"
        }
       }
      },
      "result_count": {
       "type": "integer"
      },
      "overall_sentiment": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "distribution": {
   "neutral": 5,
   "negative": 1,
   "positive": 4
  },
  "result_count": 10,
  "overall_sentiment": "positive"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-agentutility-social-sentiment-api-74e9166b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.agentutility.ai](https://www.zero.xyz/host/x402.agentutility.ai/llms.txt)