News Sentiment API
News sentiment score trends for any topic over time. Free key at trendsapi.ai
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http news-sentiment-api 'https://news-sentiment.api.trendsapi.ai/mcp' --header 'Authorization: <Bearer token. Get your free API key at https://trendsapi.ai>'{
"mcpServers": {
"news-sentiment-api": {
"type": "http",
"url": "https://news-sentiment.api.trendsapi.ai/mcp",
"headers": {
"Authorization": "<Bearer token. Get your free API key at https://trendsapi.ai>"
}
}
}
}Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
News sentiment API
News tone over time via the Trends API. Sentiment history and growth without scraping outlets.
Key: trendsapi.ai/#get-key. HTTP contract and every source: trendsapi-ai/trendsapi.
Authentication
pip install trendsapi-news-sentiment
export TRENDSAPI_KEY=your_keyPython 3.9+. Same key as the HTTP API.
from trendsapi_news_sentiment import TrendsAPI
client = TrendsAPI() # TRENDSAPI_KEY
# client = TrendsAPI(api_key="YOUR_KEY")Keyword helpers default to source: "news sentiment". Pass source= to hit any other platform with the same client. Official full client (every source, no preset): trendsapi.
Methods
| Method | REST mode | Returns |
|---|---|---|
get_time_series(keyword, source=, data_mode=) | get_time_series | list[TrendsDataPoint] |
get_growth(keyword, percent_growth=, source=, data_mode=) | get_growth | GetGrowthResponse |
get_top_trends(type=, ...) | get_top_trends | GetTopTrendsResponse |
source is lowercase (news sentiment). type is exact (Google Trends). Mixing them is a 400.
from trendsapi_news_sentiment import TrendsAPI
client = TrendsAPI() # TRENDSAPI_KEY
# client = TrendsAPI(api_key="YOUR_KEY")
series = client.get_time_series("nvidia")
print(series[-1].date, series[-1].value)
growth = client.get_growth("nvidia", percent_growth=["3M", "12M"])
print(growth.results[0].growth, growth.results[0].direction)get_time_series
points = client.get_time_series("nvidia")Each point:
| Field | Always | Meaning |
|---|---|---|
date | yes | YYYY-MM-DD |
value | yes | 0-100 index for this series |
keyword | yes | Echo |
volume | no | Absolute volume when available |
source or datatype | no | Pipeline label |
Python returns list[TrendsDataPoint]. Use .date and .value, not ["date"].
JS returns the same fields as object properties.
get_growth
g = client.get_growth("nvidia", percent_growth=["12M", "3M", "YTD"])
print(g.results[0].growth, g.results[0].direction)percent_growth default: ["12M"]. Presets: 7D 14D 30D 1M 2M 3M 6M 9M 12M/1Y 18M 24M/2Y 36M/3Y 48M 60M/5Y MTD QTD YTD. Custom: {"name": "Launch", "recent": "2024-06-01", "baseline": "2024-01-01"}.
| Field | Meaning |
|---|---|
search_term | Keyword |
data_source | Source |
results | One object per window (period, growth, direction, dates, values) |
metadata | Counts / success flag |
Several windows still count as one request. Python: growth.results[0].growth. JS: growth.results[0].growth.
Async
import asyncio
from trendsapi_news_sentiment import AsyncTrendsAPI
async def main():
c = AsyncTrendsAPI()
return await asyncio.gather(
c.get_time_series("nvidia"),
c.get_time_series("nvidia", source="google search"),
)
asyncio.run(main())Each 200 is one billed request.
Pandas
from dataclasses import asdict
import pandas as pd
from trendsapi_news_sentiment import TrendsAPI
df = pd.DataFrame(asdict(p) for p in TrendsAPI().get_time_series("nvidia"))
df["date"] = pd.to_datetime(df["date"])
print(df.set_index("date")["value"].resample("ME").mean().tail())Call (curl)
| Field | Value |
|---|---|
| Endpoint | POST https://api.trendsapi.ai/api |
| Auth | Authorization: Bearer $TRENDSAPI_KEY |
| History | source: news sentiment with get_time_series or get_growth |
| Keyword | Any phrase, e.g. nvidia |
Live type | n/a |
curl -sS -X POST https://api.trendsapi.ai/api \
-H "Authorization: Bearer $TRENDSAPI_KEY" \
-H "Content-Type: application/json" \
--max-time 60 \
-d '{"mode":"get_time_series","source":"news sentiment","keyword":"nvidia"}'Source notes
- Negative
growthmeans tone fell vs the prior window, not that the company is negative. - Mention count is
news-trends-api(source: news volume). - No per-article labels, no outlet breakdown.
Errors
| HTTP | Client |
|---|---|
| 200 | Parsed payload. Python dataclasses / JS typed objects |
| 400 | Raises. Fix source or type spelling |
| 401 | Raises. Check TRENDSAPI_KEY |
| 404 | Raises. No series for that keyword. Do not retry |
| 429 | Raises. Quota |
| 5xx | Client retries, then raises |
The HTTP body field is a JSON string. SDKs decode it. Raw curl must parse body a second time.
Site: https://trendsapi.ai/trends/news-sentiment.
License
MIT. See LICENSE.
Questions fréquentes
Qu'est-ce que News Sentiment API ?
News sentiment score trends for any topic over time. Free key at trendsapi.ai
Comment installer News Sentiment API ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http news-sentiment-api 'https://news-sentiment.api.trendsapi.ai/mcp' --header 'Authorization: <Bearer token. Get your free API key at https://trendsapi.ai>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour News Sentiment API ?
Oui. Il attend Authorization, à renseigner dans sa configuration.
News Sentiment API est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient News Sentiment API ?
Il est publié par trendsapi-ai. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.