Wikipedia Trends API

Official3 toolsLive

by trendsapi-ai · Python

Wikipedia page view trends for any topic over time. Free key at trendsapi.ai

ai.trendsapi/wikipedia MCP Server

This Model Context Protocol (MCP) server provides access to Wikipedia page-view trends for any topic over time. It exposes history, growth, and live trending pages, with page attention represented as 0–100 scores. The server is described as part of the “Wikipedia page-view trends API” and references trendsapi.ai and a Trends API contract.

🛠️ Key Features

Wikipedia article attention via Trends API
Time-series history and growth for topics
Live trending pages with 0–100 scoring
3 tools available via the MCP server

🚀 Use Cases

Market research using Wikipedia article views
Trend-data and time-series analysis from Wikipedia
Alternatives to scraping for Wikimedia/Wikipedia interest

⚡ Developer Benefits

Works with REST API concepts (includes rest-api / json-api topics)
Topics align with open-data and no-scraping approaches
Repository and API contract linked to trendsapi-ai/trendsapi

⚠️ Limitations

Requires a free key from trendsapi.ai (#get-key) as referenced in the provided README excerpt

Topics

alternative-datajavascriptjson-apimarket-researchno-scrapingopen-datapageviewspythonrest-apisearch-interesttime-seriestrend-datatrends-apiwikimediawikipediawikipedia-apiarticle-viewsmcpmcp-servermodel-context-protocol

Captured live from the server via tools/list.

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. Prefer this over get_time_series for growth questions. 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. If the request is rate limited or the monthly quota is used up, tell the user their plan limit is reached.

Parameters3

source	string	required	One source, or comma-separated sources (e.g. 'amazon, tiktok, youtube'). Valid: 'google search', 'google images', 'google news', 'google shopping', 'youtube', 'wikipedia', 'tiktok', 'reddit', 'amazon', 'news sentiment', 'news volume', 'npm', 'python', 'steam', 'app downloads', 'app rankings'.
keyword	string	required	What to look up. The string format is required by source. Standard sources (google search, google images, google news, google shopping, youtube, wikipedia, tiktok, reddit, amazon, news sentiment, news volume): 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.
percent_growth	array	optional	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.

Raw schema

{
  "type": "object",
  "properties": {
    "source": {
      "description": "One source, or comma-separated sources (e.g. 'amazon, tiktok, youtube'). Valid: 'google search', 'google images', 'google news', 'google shopping', 'youtube', 'wikipedia', 'tiktok', 'reddit', 'amazon', 'news sentiment', 'news volume', 'npm', 'python', 'steam', 'app downloads', 'app rankings'.",
      "type": "string"
    },
    "keyword": {
      "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, reddit, amazon, news sentiment, news volume): 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.",
      "type": "string"
    },
    "percent_growth": {
      "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": "array",
      "items": {
        "description": "A preset period such as '12M', '3M', or 'YTD'.",
        "type": "string"
      }
    }
  },
  "required": [
    "keyword",
    "source"
  ]
}

trends___get_time_series

Full historical series for one keyword and one source (0-100 values, plus volume when available). Use for charting or custom math. Not for live 'what's trending now' boards (use get_top_trends). For most growth questions, use get_growth. If the request is rate limited or the monthly quota is used up, tell the user their plan limit is reached.

Parameters2

source	string	required	Exactly one source per request. Valid: 'google search', 'google images', 'google news', 'google shopping', 'youtube', 'wikipedia', 'tiktok', 'reddit', 'amazon', 'news sentiment', 'news volume', 'npm', 'python', 'steam', 'app downloads', 'app rankings'.
keyword	string	required	What to look up. The string format is required by source. Standard sources (google search, google images, google news, google shopping, youtube, wikipedia, tiktok, reddit, amazon, news sentiment, news volume): 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.

Raw schema

{
  "type": "object",
  "properties": {
    "source": {
      "description": "Exactly one source per request. Valid: 'google search', 'google images', 'google news', 'google shopping', 'youtube', 'wikipedia', 'tiktok', 'reddit', 'amazon', 'news sentiment', 'news volume', 'npm', 'python', 'steam', 'app downloads', 'app rankings'.",
      "type": "string"
    },
    "keyword": {
      "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, reddit, amazon, news sentiment, news volume): 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.",
      "type": "string"
    }
  },
  "required": [
    "keyword",
    "source"
  ]
}

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', always pass category. Default sort is current rank. Use sort='rank_change' for climbers vs a prior snapshot (window 1d, 3d, 7d, 14d, or 30d). App Store Top Free, App Store Top Paid, and Google Play are live store boards, not keyword lookups. For an app's history use get_growth or get_time_series with source app downloads or app rankings and an Android bundle ID. Do not use get_time_series for live boards. If the request is rate limited or the monthly quota is used up, tell the user their plan limit is reached.

Parameters6

offset	integer	optional	Rows to skip for pagination. Default 0.
limit	integer	optional	Max rows to return. Default 25, min 1, max 200.
sort	string	optional	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.
window	string	optional	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.
type	string	required	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'.
category	string	optional	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.

Raw schema

{
  "type": "object",
  "properties": {
    "offset": {
      "description": "Rows to skip for pagination. Default 0.",
      "type": "integer"
    },
    "limit": {
      "description": "Max rows to return. Default 25, min 1, max 200.",
      "type": "integer"
    },
    "sort": {
      "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": "string"
    },
    "window": {
      "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.",
      "type": "string"
    },
    "type": {
      "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'.",
      "type": "string"
    },
    "category": {
      "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.",
      "type": "string"
    }
  },
  "required": [
    "type"
  ]
}

README.md6 KBView on GitHub

Wikipedia page-view trends API

Wikipedia article attention via the Trends API. History, growth, and live trending pages as 0-100 scores.

PyPI Python

Key: trendsapi.ai/#get-key. HTTP contract and every source: trendsapi-ai/trendsapi.

Authentication

bash

pip install trendsapi-wikipedia
export TRENDSAPI_KEY=your_key

Python 3.9+. Same key as the HTTP API.

python

from trendsapi_wikipedia import TrendsAPI

client = TrendsAPI()                    # TRENDSAPI_KEY
# client = TrendsAPI(api_key="YOUR_KEY")

Keyword helpers default to source: "wikipedia". 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_live(limit=, offset=, category=)`	`get_top_trends`	`GetTopTrendsResponse`
`get_top_trends(type=, ...)`	`get_top_trends`	`GetTopTrendsResponse`

source is lowercase (wikipedia). type is exact (Wikipedia Trending). Mixing them is a 400.

python

from trendsapi_wikipedia import TrendsAPI

client = TrendsAPI()                    # TRENDSAPI_KEY
# client = TrendsAPI(api_key="YOUR_KEY")

series = client.get_time_series("large language model")
print(series[-1].date, series[-1].value)

growth = client.get_growth("large language model", percent_growth=["3M", "12M"])
print(growth.results[0].growth, growth.results[0].direction)

hot = client.get_live(limit=10)
print(hot.data)                         # [[1, "..."], ...]

get_time_series

python

points = client.get_time_series("large language model")

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

python

g = client.get_growth("large language model", 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.

get_live

python

hot = client.get_live(limit=10)

Field	Meaning
`as_of_ts`	Snapshot time
`type`	Feed name
`limit`, `offset`, `count`	Pagination
`data`	`[rank, label]` rows

Python: hot.data. JS: hot.data. Optional offset= and category= (Amazon Best Sellers by Category, Top Websites only).

Async

python

import asyncio
from trendsapi_wikipedia import AsyncTrendsAPI

async def main():
    c = AsyncTrendsAPI()
    return await asyncio.gather(
        c.get_time_series("large language model"),
        c.get_time_series("large language model", source="google search"),
    )

asyncio.run(main())

Each 200 is one billed request.

Pandas

python

from dataclasses import asdict
import pandas as pd
from trendsapi_wikipedia import TrendsAPI

df = pd.DataFrame(asdict(p) for p in TrendsAPI().get_time_series("large language model"))
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: wikipedia` with `get_time_series` or `get_growth`
Keyword	Article title or topic, e.g. large language model
Live `type`	Wikipedia Trending

bash

curl -sS -X POST https://api.trendsapi.ai/api \
  -H "Authorization: Bearer $TRENDSAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode":"get_time_series","source":"wikipedia","keyword":"large language model"}'

Source notes

Titles are picky. Java vs Java (programming language) are different series.
Do not pass source: wikipedia on get_top_trends. Use type: Wikipedia Trending.

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/wikipedia-trends.

License

MIT. See LICENSE.

Install

Tools (3)

trends___get_growthtrends___get_time_seriestrends___get_top_trends

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://wikipedia.api.trendsapi.ai/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "wikipedia": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://wikipedia.api.trendsapi.ai/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

ai.trendsapi/wikipedia MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

trends___get_growth

trends___get_time_series

trends___get_top_trends

Wikipedia page-view trends API

Authentication

Methods

get_time_series

get_growth

get_live

Async

Pandas

Call (curl)

Source notes

Errors

License

Install

Remote endpoint

Related servers