Skip to main content

News sentiment score (positive/negative) over time via a Python client. Weekly or daily series, period-over-period growth, zero dependencies beyond httpx. Powered by trendsmcp.ai

Project description

news-sentiment-api

The number one Python package for News Sentiment trend data. News sentiment score (positive/negative) over time via a Python client. Weekly or daily series, period-over-period growth, zero dependencies beyond httpx.

Powered by trendsmcp.ai, the #1 MCP server for live trend data.

Get your free API key at trendsmcp.ai - 100 free requests per month, no credit card.

📖 Full API docs → trendsmcp.ai/docs

Updated for 2026. Works with Python 3.8 through 3.13.


No scraping. No 429 errors. No proxies.

If you have used pytrends or similar scrapers before, you know the problems: random 429 Too Many Requests blocks, broken pipelines at 2am, time.sleep() hacks, proxy rotation costs, and a library that is now archived because Google explicitly flags scrapers at the protocol level.

trendsmcp is the managed alternative. We run the data infrastructure. You call a REST endpoint.

pytrends alternative for News Sentiment data

Scrapers / pytrends trendsmcp
429 rate limit errors constant never
Proxy required often never
Breaks on platform changes yes, regularly no
Platforms covered 1 (Google only) 13
Absolute volume estimates no yes
Cross-platform growth no yes
Async support no yes
Actively maintained no (archived) yes
Free tier no yes, 100 req/month

Install

pip install news-sentiment-api

Zero system dependencies. Python 3.8 or later. Uses httpx under the hood.


Quick start

from news_sentiment_api import TrendsMcpClient, SOURCE

client = TrendsMcpClient(api_key="YOUR_API_KEY")

# 5-year weekly time series, no sleep(), no proxies, no 429s
series = client.get_trends(source=SOURCE, keyword="bitcoin")
print(series[0])
# TrendsDataPoint(date='2026-03-28', value=72, keyword='bitcoin', source='news sentiment')

# Period-over-period growth
growth = client.get_growth(
    source=SOURCE,
    keyword="bitcoin",
    percent_growth=["3M", "1Y"],
)
print(growth.results[0])
# GrowthResult(period='3M', growth=14.5, direction='increase', ...)

# What's trending right now
trending = client.get_top_trends(limit=10)
print(trending.data)
# [[1, 'topic one'], [2, 'topic two'], ...]

Async support

import asyncio
from news_sentiment_api import AsyncTrendsMcpClient, SOURCE

async def main():
    client = AsyncTrendsMcpClient(api_key="YOUR_API_KEY")
    series = await client.get_trends(source=SOURCE, keyword="bitcoin")
    print(series[0])

asyncio.run(main())

Run multiple platform queries concurrently:

google, youtube, reddit = await asyncio.gather(
    client.get_trends(source="google search", keyword="bitcoin"),
    client.get_trends(source="youtube",       keyword="bitcoin"),
    client.get_trends(source="reddit",        keyword="bitcoin"),
)

Use cases

  • SEO research: track keyword search volume trends across Google Search, Google News, and Google Images before publishing content
  • Market research: measure consumer demand signals on Amazon and Google Shopping before entering a product category
  • Investment research: monitor Reddit discussion volume, news sentiment, and Wikipedia page view spikes as leading indicators
  • Content strategy: find what is growing on YouTube and TikTok before topics peak and competition saturates them
  • Competitor tracking: compare brand search volume growth across platforms over custom date ranges

Works with

  • Claude (via MCP server at trendsmcp.ai)
  • Cursor (via MCP server at trendsmcp.ai)
  • ChatGPT (via MCP server at trendsmcp.ai)
  • VS Code Copilot (via MCP server at trendsmcp.ai)
  • LangChain: pass TrendsMcpClient output directly as tool results or context
  • LlamaIndex: use trend series as structured data nodes for retrieval
  • Pandas: each get_trends() response converts to a DataFrame in one line

Methods

get_trends(source, keyword, data_mode=None)

Returns a historical time series for a keyword. Defaults to 5 years of weekly data. Pass data_mode="daily" for the last 30 days at daily granularity.

get_growth(source, keyword, percent_growth, data_mode=None)

Calculates percentage growth between two points in time. Pass preset strings or CustomGrowthPeriod objects.

Growth presets: 7D 14D 30D 1M 2M 3M 6M 9M 12M 1Y 18M 24M 2Y 36M 3Y 48M 60M 5Y MTD QTD YTD

get_top_trends(type=None, limit=None)

Returns today's live trending items. Omit type to get all feeds at once.

Available feeds: Google Trends YouTube TikTok Trending Hashtags Reddit Hot Posts Amazon Best Sellers Top Rated App Store Top Free Wikipedia Trending Spotify Top Podcasts X (Twitter) and more.


All 13 supported sources

One API key. One client. All platforms. No separate credentials for each.

source What it measures
"google search" Google Search volume
"google images" Google Images search volume
"google news" Google News search volume
"google shopping" Google Shopping purchase intent
"youtube" YouTube search volume
"tiktok" TikTok hashtag volume
"reddit" Reddit mention volume
"amazon" Amazon product search volume
"wikipedia" Wikipedia page views
"news volume" News article mention count
"news sentiment" News sentiment score (positive/negative)
"npm" npm package weekly downloads
"steam" Steam concurrent player count

All values normalized 0 to 100 on the same scale so you can compare across platforms directly.


Error handling

from news_sentiment_api import TrendsMcpClient, TrendsMcpError, SOURCE

client = TrendsMcpClient(api_key="YOUR_API_KEY")

try:
    series = client.get_trends(source=SOURCE, keyword="bitcoin")
except TrendsMcpError as e:
    print(e.status)   # e.g. 429 if you exceed your plan quota
    print(e.code)     # e.g. "rate_limited"
    print(e.message)

Frequently asked questions

Does this scrape News Sentiment? No. trendsmcp runs managed data infrastructure. Your Python code makes a single authenticated REST call. No scraping, no Selenium, no cookies, no proxies required.

Do I need a News Sentiment developer account, OAuth token, or platform API key? No. One trendsmcp API key gives you access to all 13 sources.

Will it break when News Sentiment changes its backend? No. API stability is our responsibility. If something changes upstream, we update the backend. Your code keeps working.

Is there a free tier? Yes, 100 requests per month, no credit card required. Get your key at trendsmcp.ai.

Can I use this in production data pipelines? Yes. The client is stateless, thread-safe, and supports async for concurrent queries across multiple platforms.


Related packages


Links


License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

news_sentiment_api-1.0.0.tar.gz (5.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

news_sentiment_api-1.0.0-py3-none-any.whl (6.0 kB view details)

Uploaded Python 3

File details

Details for the file news_sentiment_api-1.0.0.tar.gz.

File metadata

  • Download URL: news_sentiment_api-1.0.0.tar.gz
  • Upload date:
  • Size: 5.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for news_sentiment_api-1.0.0.tar.gz
Algorithm Hash digest
SHA256 ce895f5a548d3d7e899cf16622f44f47bb1bb06238360ff74cffd0cb3044e217
MD5 09396fa04a453275293e4d9b00e491b7
BLAKE2b-256 b4517f33a8b83e607c1657adc4c02397384a17a2b873fd85b3e20ca801f9e749

See more details on using hashes here.

Provenance

The following attestation bundles were made for news_sentiment_api-1.0.0.tar.gz:

Publisher: publish.yml on trendsmcp/news-sentiment-api

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file news_sentiment_api-1.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for news_sentiment_api-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 5d8658e990c8a81ee51e2008b920bb98d31e73a5e64438a93020d491a48be26b
MD5 0fb491b8318ea9b06123be7f633d3ad3
BLAKE2b-256 56b5f577703a26bf292e599a5a4b8f1506350bdd2e58333dfb6d80578269dc60

See more details on using hashes here.

Provenance

The following attestation bundles were made for news_sentiment_api-1.0.0-py3-none-any.whl:

Publisher: publish.yml on trendsmcp/news-sentiment-api

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page