Skip to main content

news-volume-agent

News article mention volume as a ready-made tool for LangChain, CrewAI, AutoGen, and any tool-calling AI agent. Weekly or daily series, growth percentages. No media database subscription.

Powered by trendsmcp.ai — one API key, one client, 30+ data sources: Google Search, YouTube, TikTok, Reddit, Amazon, Wikipedia, App Store, Steam, npm, news volume, news sentiment, live trending feeds, and more. No separate credentials per platform.

Get your free API key → trendsmcp.ai — 100 free requests/month, no credit card.

📖 Full API docs → trendsmcp.ai/docs

Updated for 2026. Works with Python 3.8 through 3.13.

Use in your agent

Pass TrendsMcpClient as a tool to any framework that accepts callables or tool objects:

from news_volume_agent import TrendsMcpClient, SOURCE

client = TrendsMcpClient(api_key="YOUR_API_KEY")

# Use directly in any agent tool-calling loop
def get_news_volume_trend(keyword: str) -> list:
    """Return weekly trend history for a News Volume keyword."""
    return client.get_trends(source=SOURCE, keyword=keyword)

def get_news_volume_growth(keyword: str) -> dict:
    """Return 3M and 1Y growth for a News Volume keyword."""
    return client.get_growth(source=SOURCE, keyword=keyword, percent_growth=["3M", "1Y"])

Or query any of the other 30+ data sources with the same key:

# Same client, any platform — no extra credentials
google  = client.get_trends(source="google search", keyword="climate change")
youtube = client.get_trends(source="youtube",        keyword="climate change")
reddit  = client.get_trends(source="reddit",         keyword="climate change")
amazon  = client.get_trends(source="amazon",         keyword="climate change")
tiktok  = client.get_trends(source="tiktok",         keyword="climate change")

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 Volume data

Scrapers / pytrends trendsmcp
429 rate limit errors constant never
Proxy required often never
Breaks on platform changes yes, regularly no
Data sources covered 1 (Google only) 30+
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-volume-agent

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


Quick start

from news_volume_agent 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="climate change")
print(series[0])
# TrendsDataPoint(date='2026-03-28', value=72, keyword='climate change', source='news volume')

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

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

Async support

import asyncio
from news_volume_agent import AsyncTrendsMcpClient, SOURCE

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

asyncio.run(main())

Query multiple platforms concurrently with one key:

google, youtube, reddit, amazon, tiktok = await asyncio.gather(
    client.get_trends(source="google search", keyword="climate change"),
    client.get_trends(source="youtube",       keyword="climate change"),
    client.get_trends(source="reddit",        keyword="climate change"),
    client.get_trends(source="amazon",        keyword="climate change"),
    client.get_trends(source="tiktok",        keyword="climate change"),
)

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
  • App analytics: track App Store interest and app download estimates alongside Reddit and news buzz

Works with

  • Claude (via MCP — trendsmcp.ai/docs)
  • Cursor (via MCP — trendsmcp.ai/docs)
  • ChatGPT (via MCP — trendsmcp.ai/docs)
  • Windsurf (via MCP — trendsmcp.ai/docs)
  • VS Code Copilot (via MCP — trendsmcp.ai/docs)
  • LangChain: pass TrendsMcpClient output directly as tool results or context
  • CrewAI: wrap any method as a Tool and drop it into your crew
  • AutoGen: register as a callable tool for any agent
  • 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 live feeds: Google Trends Google News Top News YouTube Trending TikTok Trending Hashtags X (Twitter) Trending Reddit Hot Posts Reddit World News Wikipedia Trending Amazon Best Sellers Top Rated Amazon Best Sellers by Category App Store Top Free App Store Top Paid Google Play Spotify Top Podcasts Top Websites


All 30+ data sources

One API key. One client. Every platform. 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 subreddit subscribers over time
"amazon" Amazon product search volume
"wikipedia" Wikipedia page views
"news volume" News article mention count
"news sentiment" News sentiment score (positive/negative)
"app downloads" Mobile app download/install estimates (Android)
"npm" npm package weekly downloads
"steam" Steam concurrent player count

All values normalized 0–100 so you can compare across platforms directly.


Error handling

from news_volume_agent import TrendsMcpClient, TrendsMcpError, SOURCE

client = TrendsMcpClient(api_key="YOUR_API_KEY")

try:
    series = client.get_trends(source=SOURCE, keyword="climate change")
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 Volume? 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 Volume developer account, OAuth token, or platform API key? No. One trendsmcp API key gives you access to all 30+ data sources.

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

Can I query multiple platforms with the same key? Yes. One key covers every data source. Switch source to any of the 30+ values listed above.

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

Release files for news-volume-agent 1.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for news-volume-agent 1.1.0
File Size Uploaded
news_volume_agent-1.1.0.tar.gz 6.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for news-volume-agent 1.1.0
File Interpreter ABI Platform
news_volume_agent-1.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 13.2 kB

Release files / news_volume_agent-1.1.0.tar.gz

Download URL news_volume_agent-1.1.0.tar.gz
Size 6.4 kB
Tags Source
SHA-256 checksum
How to use checksums
7d9ddeb79c8c8999f5a088ec7b47abb5e9f9d82a249eac9b6ab8e15f06175eee
BLAKE2b-256 checksum
How to use checksums
08db3a993b6ab4f8b231cb20d34e996c8439d665d212b1c0f7db5d3ecc9f7c10
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.2

Release files / news_volume_agent-1.1.0-py3-none-any.whl

Download URL news_volume_agent-1.1.0-py3-none-any.whl
Size 6.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
db4e08d3e48a5eccce3fb16ac7ee96502d591627bd623ba9a0a88e711ba49f47
BLAKE2b-256 checksum
How to use checksums
cf5e60fe6b3e496738279bf3100e62fcd58fbbd09410aa42b4acd5fcf7555eef
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.2

Release history Release notifications | RSS feed

This release

1.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page