News Sentiment API

Working · 1.7 s

ai.trendsapi/news-sentimentv1.0.2 Domain verified

News sentiment score trends for any topic over time. Free key at trendsapi.ai

News & Media

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://news-sentiment.api.trendsapi.ai/mcp

Authorization (required)

Bearer token. Get your free API key at https://trendsapi.ai

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

trends___get_context Read-only

What people are posting, reading and betting about a keyword right now. Returns recent posts, videos, news stories, discussions and prediction markets per source, with engagement (views, likes, score) and top comments. Use it to explain why something is trending or what the conversation says; get_time_series and get_growth measure how much. Costs 1 request per source. Returns a plan-limit message when the request is rate limited or the monthly quota is used up.

sourcestring, required

One source, or up to 5 comma-separated. Valid: 'News', 'YouTube', 'TikTok', 'Instagram', 'X', 'Reddit', 'Bluesky', 'Hacker News', 'Polymarket', 'GitHub'.

keywordstring, required

Any name or phrase, e.g. 'nintendo switch 2'.

daysinteger

Look back this many days, 1 to 30. Default 7.

limitinteger

Items per source, 1 to 20. Default 10.

commentsinteger

Top comments for the first N items of each source, 0 to 5. Default 2. Only for 'YouTube', 'TikTok', 'Instagram', 'X', 'Reddit', 'Bluesky', and 'Hacker News'.

Tools (6)

Tool list last changed Oct 26, 2026.

trends___get_context

read-only

Argument	Type	Description
days	integer	Look back this many days, 1 to 30. Default 7.
limit	integer	Items per source, 1 to 20. Default 10.
source*	string	One source, or up to 5 comma-separated. Valid: 'News', 'YouTube', 'TikTok', 'Instagram', 'X', 'Reddit', 'Bluesky', 'Hacker News', 'Polymarket', 'GitHub'.
keyword*	string	Any name or phrase, e.g. 'nintendo switch 2'.
comments	integer	Top comments for the first N items of each source, 0 to 5. Default 2. Only for 'YouTube', 'TikTok', 'Instagram', 'X', 'Reddit', 'Bluesky', and 'Hacker News'.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "keyword",
    "source"
  ],
  "properties": {
    "days": {
      "type": "integer",
      "description": "Look back this many days, 1 to 30. Default 7."
    },
    "limit": {
      "type": "integer",
      "description": "Items per source, 1 to 20. Default 10."
    },
    "source": {
      "type": "string",
      "description": "One source, or up to 5 comma-separated. Valid: 'News', 'YouTube', 'TikTok', 'Instagram', 'X', 'Reddit', 'Bluesky', 'Hacker News', 'Polymarket', 'GitHub'."
    },
    "keyword": {
      "type": "string",
      "description": "Any name or phrase, e.g. 'nintendo switch 2'."
    },
    "comments": {
      "type": "integer",
      "description": "Top comments for the first N items of each source, 0 to 5. Default 2. Only for 'YouTube', 'TikTok', 'Instagram', 'X', 'Reddit', 'Bluesky', and 'Hacker News'."
    }
  }
}

trends___get_growth

Point-to-point growth for a keyword on one or more sources. Each window is a preset string (12M, 3M, YTD, and the other listed periods). Values are on a 0-100 scale, plus absolute volume when available. Designed for growth questions; for charting or custom math, get_time_series provides the full series. App Downloads and App Rankings are keyword sources (Android bundle ID). They are not the App Store / Google Play live boards on get_top_trends. Returns a plan-limit message when the request is rate limited or the monthly quota is used up.

read-only

Argument	Type	Description
source*	string	One source, or comma-separated sources (e.g. 'Amazon, TikTok, YouTube'). Valid: 'Google Search', 'Google Images', 'Google News', 'Google Shopping', 'YouTube', 'Wikipedia', 'TikTok', 'Amazon', 'npm', 'Python', 'Steam', 'App Downloads', 'App Rankings'.
country	string	Optional ISO 3166-1 alpha-2 code (US, GB, JP). Aliases like 'UK' or 'United Kingdom' resolve too. Only for Google Search, Google Images, Google News, Google Shopping, YouTube, and TikTok. Google defaults to worldwide, TikTok to US; with a country the data is fetched live.
keyword*	string	What to look up. The string format is required by source. Standard sources (Google Search, Google Images, Google News, Google Shopping, YouTube, Wikipedia, TikTok, Amazon): any name or phrase, e.g. 'nike'. npm: Exact npmjs.com package name, case-sensitive. Right: 'react', '@babel/core'. Wrong: 'React', 'React.js'. Python: Exact PyPI project name. Right: 'pandas', 'requests'. Wrong: 'Pandas'. Steam: Game display name in plain English, not a Steam App ID. Right: 'Elden Ring', 'CS2'. First Steam store search result wins, so use an unambiguous name. App Downloads and App Rankings: Android bundle ID only (the id= value on Google Play). Right: 'com.openai.chatgpt', 'com.whatsapp'. Wrong: 'ChatGPT', 'WhatsApp', an iOS App Store ID, or a bundle ID that is not Android. Find it at play.google.com/store/apps/details?id=THIS_PART. If the request includes App Downloads or App Rankings with other sources, keyword must still be the Android bundle ID.

trends___get_time_series

Full historical series for one keyword and one source (0-100 values, plus volume when available). Suited for charting or custom math. Live 'what's trending now' boards are on get_top_trends. get_growth answers most growth questions with less data. Returns a plan-limit message when the request is rate limited or the monthly quota is used up.

read-only

Argument	Type	Description
source*	string	Exactly one source per request. Valid: 'Google Search', 'Google Images', 'Google News', 'Google Shopping', 'YouTube', 'Wikipedia', 'TikTok', 'Amazon', 'npm', 'Python', 'Steam', 'App Downloads', 'App Rankings'.
country	string	Optional ISO 3166-1 alpha-2 code (US, GB, JP). Aliases like 'UK' or 'United Kingdom' resolve too. Only for Google Search, Google Images, Google News, Google Shopping, YouTube, and TikTok. Google defaults to worldwide, TikTok to US; with a country the data is fetched live.
keyword*	string	What to look up. The string format is required by source. Standard sources (Google Search, Google Images, Google News, Google Shopping, YouTube, Wikipedia, TikTok, Amazon): any name or phrase, e.g. 'tesla'. npm: Exact npmjs.com package name, case-sensitive. Right: 'react', '@babel/core'. Wrong: 'React', 'React.js'. Python: Exact PyPI project name. Right: 'pandas', 'requests'. Wrong: 'Pandas'. Steam: Game display name in plain English, not a Steam App ID. Right: 'Elden Ring', 'CS2'. First Steam store search result wins, so use an unambiguous name. App Downloads and App Rankings: Android bundle ID only (the id= value on Google Play). Right: 'com.openai.chatgpt', 'com.whatsapp'. Wrong: 'ChatGPT', 'WhatsApp', an iOS App Store ID, or a bundle ID that is not Android. Find it at play.google.com/store/apps/details?id=THIS_PART.

trends___get_top_posts

Live top posts for one hashtag on one social source. Fetched live on every call; nothing is stored. For when the user already has a hashtag and wants the posts winning on it. get_top_trends ranks the hashtags themselves. Returns a plan-limit message when the request is rate limited or the monthly quota is used up.

read-only

Argument	Type	Description
limit	integer	Max posts to return. Default 20, min 1, max 20.
source*	string	Exactly one source per request. Valid: 'TikTok', 'Instagram'.
keyword*	string	The hashtag, with or without '#'. Spaces are removed. Example: 'bookstagram' or '#fitness'.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "keyword",
    "source"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Max posts to return. Default 20, min 1, max 20."
    },
    "source": {
      "type": "string",
      "description": "Exactly one source per request. Valid: 'TikTok', 'Instagram'."
    },
    "keyword": {
      "type": "string",
      "description": "The hashtag, with or without '#'. Spaces are removed. Example: 'bookstagram' or '#fitness'."
    }
  }
}

trends___get_top_trends

Live top-trending board for exactly one feed type. No keyword. For 'Amazon Best Sellers by Category', 'Google Trends by Category', 'Top Websites', 'Substack by Category', and 'TikTok Trending Hashtags by Category', category selects the board. Default sort is current rank. Use sort='rank_change' for climbers vs a prior snapshot (window 1d, 3d, 7d, 14d, or 30d). If the requested board is not in the database yet (for example a country that is not collected on the schedule), the board is fetched live. App Store Top Free, App Store Top Paid, and Google Play are live store boards, not keyword lookups. App history is available via get_growth or get_time_series with source App Downloads or App Rankings and an Android bundle ID. Live boards are only available here, not via get_time_series. Returns a plan-limit message when the request is rate limited or the monthly quota is used up.

read-only

Argument	Type	Description
sort	string	How to rank the board. 'rank' (default): current leaders. 'rank_change': biggest climbers vs a prior snapshot. Mover rows include rank, keyword, prev_rank, and rank_change.
type*	string	Exactly one live feed. Valid: 'Amazon Best Sellers Top Rated', 'Amazon Best Sellers by Category', 'App Store Top Free', 'App Store Top Paid', 'GitHub', 'Google News Top News', 'Google Play', 'Google Trends', 'Google Trends by Category', 'IMDb MOVIEmeter', 'Open Library Trending Books', 'Reddit Hot Posts', 'Reddit World News', 'Top Websites', 'Spotify Top Podcasts', 'Steam Most Played', 'Substack', 'Substack by Category', 'TikTok Trending Hashtags', 'TikTok Trending Hashtags by Category', 'TikTok Trending Searches', 'Wikipedia Trending', 'X (Twitter) Trending', 'YouTube Trending'.
limit	integer

trends___get_usage

Shows your plan, requests used this month, requests left, and when it resets. Free: does not use a request. Call it when the user asks about their limit or after a limit error.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

{ "type": "object", "required": [ "keyword", "source" ], "properties": { "source": { "type": "string", "description": "One source, or comma-separated sources (e.g. 'Amazon, TikTok, YouTube'). Valid: 'Google Search', 'Google Images', 'Google News', 'Google Shopping', 'YouTube', 'Wikipedia', 'TikTok', 'Amazon', 'npm', 'Python', 'Steam', 'App Downloads', 'App Rankings'." }, "country": { "type": "string", "description": "Optional ISO 3166-1 alpha-2 code (US, GB, JP). Aliases like 'UK' or 'United Kingdom' resolve too. Only for Google Search, Google Images, Google News, Google Shopping, YouTube, and TikTok. Google defaults to worldwide, TikTok to US; with a country the data is fetched live." }, "keyword": { "type": "string", "description": "What to look up. The string format is required by source. Standard sources (Google Search, Google Images, Google News, Google Shopping, YouTube, Wikipedia, TikTok, Amazon): any name or phrase, e.g. 'nike'. npm: Exact npmjs.com package name, case-sensitive. Right: 'react', '@babel/core'. Wrong: 'React', 'React.js'. Python: Exact PyPI project name. Right: 'pandas', 'requests'. Wrong: 'Pandas'. Steam: Game display name in plain English, not a Steam App ID. Right: 'Elden Ring', 'CS2'. First Steam store search result wins, so use an unambiguous name. App Downloads and App Rankings: Android bundle ID only (the id= value on Google Play). Right: 'com.openai.chatgpt', 'com.whatsapp'. Wrong: 'ChatGPT', 'WhatsApp', an iOS App Store ID, or a bundle ID that is not Android. Find it at play.google.com/store/apps/details?id=THIS_PART. If the request includes App Downloads or App Rankings with other sources, keyword must still be the Android bundle ID." }, "language": { "type": "string", "description": "Optional language edition code (en, de, ja, pt). Only for Wikipedia. Default en; other languages are fetched live." }, "resolution": { "type": "string", "description": "Optional. 'weekly' (default, about 5 years) or 'daily' (last 90 days, fetched live). Only for Google Search, Google Images, Google News, Google Shopping, and YouTube." }, "percent_growth": { "type": "array", "items": { "type": "string", "description": "A preset period such as '12M', '3M', or 'YTD'." }, "description": "Growth windows. Default if omitted: ['12M']. Each item must be a preset string: '7D', '1W', '14D', '2W', '30D', '1M', '2M', '3M', '6M', '9M', '12M', '1Y', '18M', '24M', '2Y', '36M', '3Y', '48M', '4Y', '60M', '5Y', 'MTD', 'QTD', 'YTD'. Every preset is a two-date comparison." } } }

{ "type": "object", "required": [ "keyword", "source" ], "properties": { "source": { "type": "string", "description": "Exactly one source per request. Valid: 'Google Search', 'Google Images', 'Google News', 'Google Shopping', 'YouTube', 'Wikipedia', 'TikTok', 'Amazon', 'npm', 'Python', 'Steam', 'App Downloads', 'App Rankings'." }, "country": { "type": "string", "description": "Optional ISO 3166-1 alpha-2 code (US, GB, JP). Aliases like 'UK' or 'United Kingdom' resolve too. Only for Google Search, Google Images, Google News, Google Shopping, YouTube, and TikTok. Google defaults to worldwide, TikTok to US; with a country the data is fetched live." }, "keyword": { "type": "string", "description": "What to look up. The string format is required by source. Standard sources (Google Search, Google Images, Google News, Google Shopping, YouTube, Wikipedia, TikTok, Amazon): any name or phrase, e.g. 'tesla'. npm: Exact npmjs.com package name, case-sensitive. Right: 'react', '@babel/core'. Wrong: 'React', 'React.js'. Python: Exact PyPI project name. Right: 'pandas', 'requests'. Wrong: 'Pandas'. Steam: Game display name in plain English, not a Steam App ID. Right: 'Elden Ring', 'CS2'. First Steam store search result wins, so use an unambiguous name. App Downloads and App Rankings: Android bundle ID only (the id= value on Google Play). Right: 'com.openai.chatgpt', 'com.whatsapp'. Wrong: 'ChatGPT', 'WhatsApp', an iOS App Store ID, or a bundle ID that is not Android. Find it at play.google.com/store/apps/details?id=THIS_PART." }, "language": { "type": "string", "description": "Optional language edition code (en, de, ja, pt). Only for Wikipedia. Default en; other languages are fetched live." }, "resolution": { "type": "string", "description": "Optional. 'weekly' (default, about 5 years) or 'daily' (last 90 days, fetched live). Only for Google Search, Google Images, Google News, Google Shopping, and YouTube." } } }

{ "type": "object", "required": [ "type" ], "properties": { "sort": { "type": "string", "description": "How to rank the board. 'rank' (default): current leaders. 'rank_change': biggest climbers vs a prior snapshot. Mover rows include rank, keyword, prev_rank, and rank_change." }, "type": { "type": "string", "description": "Exactly one live feed. Valid: 'Amazon Best Sellers Top Rated', 'Amazon Best Sellers by Category', 'App Store Top Free', 'App Store Top Paid', 'GitHub', 'Google News Top News', 'Google Play', 'Google Trends', 'Google Trends by Category', 'IMDb MOVIEmeter', 'Open Library Trending Books', 'Reddit Hot Posts', 'Reddit World News', 'Top Websites', 'Spotify Top Podcasts', 'Steam Most Played', 'Substack', 'Substack by Category', 'TikTok Trending Hashtags', 'TikTok Trending Hashtags by Category', 'TikTok Trending Searches', 'Wikipedia Trending', 'X (Twitter) Trending', 'YouTube Trending'." }, "limit": { "type": "integer", "description": "Max rows to return. Default 25, min 1, max 200." }, "offset": { "type": "integer", "description": "Rows to skip for pagination. Default 0." }, "window": { "type": "string", "description": "Lookback used only when sort is 'rank_change'. One of '1d', '3d', '7d', '14d', '30d'. Default '30d'. Short windows only work on daily feeds; weekly and monthly feeds return a note pointing to a longer window." }, "country": { "type": "string", "description": "Optional ISO 3166-1 alpha-2 code (US, GB, JP). Aliases like 'USA' or 'United States' resolve to US. Omit for the default US board. Only for Google Trends, Google Trends by Category, TikTok Trending Hashtags, TikTok Trending Hashtags by Category, X (Twitter) Trending, and YouTube Trending." }, "category": { "type": "string", "description": "Pass this whenever type is 'Amazon Best Sellers by Category', 'Google Trends by Category', 'Top Websites', 'Substack by Category', or 'TikTok Trending Hashtags by Category'. Use the official name. Without it those feeds mix every board. Only omit on a first pull to learn the official names." } } }