Overview

The Neuvia API gives you a daily time series of narrative sentiment for any entity+concept pair, along with a population-level expected sentiment baseline and 95% confidence interval. All responses are JSON. Pass your API key as a Bearer token or query param.

Authentication

Pass your API key in the Authorization header or as a query parameter:

bash
# Header (recommended)
curl -H "Authorization: Bearer nv_your_key" \
  https://neuvia.news/api/v1/trending

# Query param
curl "https://neuvia.news/api/v1/trending?api_key=nv_your_key"

Rate limits

Every response includes rate limit headers:

http
X-RateLimit-Limit: 20000
X-RateLimit-Used: 142
X-Plan: starter

Error format

Errors return a JSON object with an error field:

json
{
  "error": "Monthly call limit reached (20,000 calls).",
  "upgradeUrl": "https://neuvia.news/pricing"
}