# News Sentiment Analysis

> News Sentiment Analysis is a paid API for AI agents from agentsvc.io, paid per call via x402, $0.006/call, status unknown (last checked 2026-10-11).

Analyzes recent news sentiment for a company, token, person, or topic using AI-powered summaries across GDELT and Hacker News sources

## Facts

- Endpoint: POST https://agentsvc.io/api/v1/proxy/news-sentiment?utm_source=zero.xyz
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/news-sentiment-analysis-677a1184
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YazA0f8jCk4qEhi9rakji

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 news-sentiment-analysis-677a1184 -d '<json body>'
```

Example prompt: What's the news sentiment around Bitcoin right now? Pull up to 20 articles from the business category and give me a summary of the overall tone, the key themes, and how many articles are positive vs negative.

## When to prefer this

Choose this endpoint when you need AI-summarized, multi-article sentiment analysis for a named entity (company, token, person, or topic) sourced from a curated news index (GDELT + Hacker News), returned as a single structured payload with themes and counts — rather than raw article search or social media sentiment. It is best suited for financial research, competitive monitoring, and pre-briefing workflows where a quick, cited sentiment snapshot is more useful than a raw feed.

## Known failure modes

- Unknown or very niche topic returns sparse results with few articles
- Topic string too ambiguous may return irrelevant articles from unrelated entities with same name
- Payment failure via x402 if USDC balance is insufficient or wrong chain
- Rate limiting or upstream index unavailability may cause delayed or empty responses
- Category filter may exclude relevant coverage if topic spans multiple domains

## How this service works

86 APIs for AI agents: web scraping and crawling to Markdown, AI summaries, data extraction and cited answers, screenshots and PDF, PDF, OCR and document conversion, news, paper and developer search and more, paid per call with USDC on Base, Solana, Polygon or Arbitrum via x402. No account, no API key, free sample on every service.

## Output

Returns a JSON object with: an overall sentiment label (e.g. 'mixed'), a numeric sentiment score, per-article sentiment classifications (positive/neutral/negative) with URLs and publication dates, an aggregate count of positive/neutral/negative articles, a list of dominant themes, an AI-generated prose summary of the coverage, the AI model used (Claude Haiku), and the news index window (last 7 days, sourced from GDELT and Hacker News).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 15,
   "maximum": 25,
   "minimum": 5
  },
  "topic": {
   "type": "string",
   "description": "Company, token, person or topic, e.g. Bitcoin or Siemens"
  },
  "category": {
   "enum": [
    "general",
    "tech",
    "business",
    "science",
    "health",
    "politics"
   ],
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "model": "claude-haiku-5-5",
   "score": 0.1,
   "topic": "Bitcoin",
   "counts": {
    "neutral": 5,
    "negative": 1,
    "positive": 2
   },
   "themes": [
    "price volatility and technical levels"
   ],
   "window": "last 7 days, our news index (GDELT and Hacker News)",
   "overall": "mixed",
   "summary": "Coverage of Bitcoin is split between price-technical analysis showing uncerta...",
   "articles": [
    {
     "url": "https://economictimes.indiatimes.com/news/international/us/bitcoins-four-mont...",
     "title": "Bitcoin BTC USD price analysis: Bitcoin's four-month higher-low pattern expla...",
     "source": "indiatimes.com",
     "sentiment": "neutral",
     "published_at": "2026-10-09T21:30:00.000Z"
    }
   ],
   "analysed_at": "2026-10-10T10:12:15.017Z"
  },
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/news-sentiment-analysis-677a1184/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentsvc.io](https://www.zero.xyz/host/agentsvc.io/llms.txt)
