# News Sentiment: Headlines with Sentiment Scores

> News Sentiment: Headlines with Sentiment Scores is a paid API for AI agents from agent-data-tools.revmesh2074.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-30).

Fetches the latest news headlines on a topic from the Brave News index and scores each article positive or negative using a DistilBERT model, returning an aggregate tone summary.

## Facts

- Endpoint: GET https://agent-data-tools.revmesh2074.workers.dev/pack/news-sentiment?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Provider: agent-data-tools.revmesh2074.workers.dev
- Website: https://agent-data-tools.revmesh2074.workers.dev
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-data-tools-revmesh2074-workers-dev-news-sentiment-headlines-35ad4f04
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SUDF7p0ojvfQxi3UE93pt

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 agent-data-tools-revmesh2074-workers-dev-news-sentiment-headlines-35ad4f04
```

Example prompt: Pull the latest 10 news headlines from this past week about Nvidia and score each one positive or negative — then tell me the overall tone balance.

## When to prefer this

Choose this endpoint when you need both news retrieval and sentiment scoring in a single call without stitching together a search API and an NLP model. It is best for lightweight market mood checks, brand or competitor monitoring, or assembling a sentiment-annotated news brief. Prefer it over raw search endpoints when tone quantification matters. Note: results are for immediate use only per Brave API terms, so do not cache or re-serve articles.

## Known failure modes

- Missing required 'q' parameter returns a 400-level error
- Topic query exceeding 400 characters may be rejected or truncated
- Brave News index may return fewer articles than requested if coverage is sparse
- freshness values outside 'day', 'week', 'month' may default or error
- Sentiment model may struggle with ambiguous or very short headlines, producing near-zero scores
- Payment failure (402) halts the request before results are returned

## How this service works

The news on a topic and its tone in one call: the latest headlines from the Brave News index (title, URL, publisher, age), each with a positive or negative score from a DistilBERT model, and the balance across them. Up to 10 articles from the past day, week or month. Not a market signal. Results are for the caller's immediate use only (Brave API terms). Use for a market mood check, brand monitoring or a news brief.

## Output

Returns a list of up to 10 news articles (title, URL, publisher, age, sentiment label, and numeric score) along with an aggregate summary containing overall tone label, article count, positive count, negative count, and average sentiment score across all returned articles.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "q"
 ],
 "properties": {
  "q": {
   "type": "string",
   "description": "News topic, at most 400 characters"
  },
  "count": {
   "type": "integer",
   "description": "Number of articles (1-10, default 5)"
  },
  "freshness": {
   "type": "string",
   "description": "Only articles from the past day, week or month (default: week)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "pack": {
   "type": "string"
  },
  "query": {
   "type": "string"
  },
  "terms": {
   "type": "string"
  },
  "failed": {
   "type": "object",
   "properties": {}
  },
  "summary": {
   "type": "object",
   "properties": {
    "tone": {
     "type": "string"
    },
    "articles": {
     "type": "number"
    },
    "negative": {
     "type": "number"
    },
    "positive": {
     "type": "number"
    },
    "averageScore": {
     "type": "number"
    }
   }
  },
  "articles": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "age": {
      "type": "string"
     },
     "url": {
      "type": "string"
     },
     "score": {
      "type": "number"
     },
     "title": {
      "type": "string"
     },
     "source": {
      "type": "string"
     },
     "sentiment": {
      "type": "string"
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-data-tools-revmesh2074-workers-dev-news-sentiment-headlines-35ad4f04/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-data-tools.revmesh2074.workers.dev](https://www.zero.xyz/host/agent-data-tools.revmesh2074.workers.dev/llms.txt)
