News Volume API

What News Volume API MCP server does

News Volume API MCP server provides access to the Trends API's news-volume source for monitoring how often a topic is mentioned over time. A keyword can be any phrase, such as "federal reserve". Historical responses contain dated points with a 0–100 index, and may also include absolute volume when available.

The API also reports growth across preset or custom comparison windows. Supported presets include periods such as 7D, 30D, 3M, 12M, YTD, and 5Y. A custom comparison can specify separate recent and baseline dates. For current activity, live trend methods return ranked label rows with snapshot metadata and pagination fields.

This fits agents that need structured news attention signals, trend comparisons, or a current list of top news topics without collecting articles directly from news websites.

How it works

Requests are sent as POST calls to https://api.trendsapi.ai/api. Authentication uses the TRENDSAPI_KEY value as a bearer token. Historical requests use source: "news volume" with either get_time_series or get_growth; live news requests use the get_top_trends mode and the exact type Google News Top News.

The Python package exposes TrendsAPI and AsyncTrendsAPI. JavaScript and TypeScript applications can use the TrendsAPI client from the news-trends-api npm package. Python results use dataclasses, while JavaScript returns typed objects with equivalent fields. The async example can run multiple calls together, with each successful request counted separately for billing.

Setup and configuration

Obtain a key from trendsapi.ai and provide it through TRENDSAPI_KEY, or pass the key directly to the client constructor. Python support requires version 3.9 or newer. JavaScript support requires Node 18 or newer; the package also supports Deno, Bun, and Workers.

Python installation uses pip install news-trends-api. JavaScript and TypeScript installation uses npm install news-trends-api. The same key applies to both SDKs and the underlying HTTP API.

Tools and capabilities

The News Volume API MCP server's documented operations map to these client methods:

• get_time_series returns dated keyword observations, including the normalized value and keyword echo.
• get_growth compares one or more preset or custom periods and returns growth, direction, dates, and values.
• get_live retrieves a paginated live feed with rank-and-label rows.
• get_top_trends retrieves a live feed using an explicit trend type.

Time-series data can be converted into a pandas DataFrame in Python. Several growth windows can be requested in one API call. The source parameter can target other Trends API platforms with the same client, although this listing focuses on news volume.

Limitations and notes

News-volume requests can be slow. An HTTP 504 HTML response is not billed and can be retried. A 404 means no series exists for the keyword and should not be retried. Authentication failures return 401, quota errors return 429, and client libraries retry 5xx responses before raising an error.

Use lowercase news volume for the source. The source and live-feed type parameter are different fields, and incorrect spelling or mixing them produces a 400 response. The separate news sentiment source measures tone rather than mention count. Raw curl responses require decoding the JSON string contained in the HTTP body field; the SDKs perform that decoding.