# Web Data Toolkit

> Four public-data endpoints behind one API key: YouTube transcripts for a single video or a whole channel,
> Google Trends interest and related queries, and Google Play reviews. Available as REST and as an MCP server.

Every response has the same shape: `ok`, `count`, `seconds`, and a `data` array of rows.
Authentication is one key, sent as the `x-api-key` header or `Authorization: Bearer <key>`.
To try it without signing up, use the shared demo key `wdt_demo_public` - rate limited, and capped at 10
rows per call, but every tool answers.
Calls fetch live from the source and take roughly 4 to 25 seconds, so use a timeout of at least 60 seconds.

## Endpoints

- [GET /api/youtube/transcript](https://web-data-toolkit.vercel.app/api/youtube/transcript): transcript text for
  up to 50 videos. Required: `url`. Optional: `lang`, `translateTo`, `segments`.
- [GET /api/youtube/channel](https://web-data-toolkit.vercel.app/api/youtube/channel): every recent video of a
  channel, @handle or playlist, each with its transcript. Required: `source` - a channel, @handle,
  playlist, or `search: your query` to search YouTube and get the top results with transcripts.
  Optional: `max`, `lang`.
- [GET /api/trends](https://web-data-toolkit.vercel.app/api/trends): Google Trends interest over time, interest
  by region, top and rising related queries. Required: `keyword`. Optional: `geo`, `timeframe`, `byRegion`, `related`.
- [GET /api/google-play/reviews](https://web-data-toolkit.vercel.app/api/google-play/reviews): Google Play
  reviews including the developer reply. Required: `app`. Optional: `country`, `lang`, `max`, `rating`.

## MCP

- [POST /mcp](https://web-data-toolkit.vercel.app/mcp): the same four tools over Model Context Protocol
  (JSON-RPC 2.0, Streamable HTTP, stateless). Tool names: `youtube_transcript`, `youtube_channel_transcripts`,
  `google_trends`, `google_play_reviews`. MCP results are summarised for a context window rather than dumped:
  one Trends keyword is ~37,000 characters of JSON but ~1,200 characters as an MCP answer. Pass `raw: true`
  for every field. Use the demo key `wdt_demo_public` to start. A RapidAPI
  subscription issues a key for RapidAPI's own gateway and does NOT authenticate here; for a personal key
  with higher limits, open an issue at https://github.com/leekung125/web-data-toolkit-mcp/issues.

## Optional

- [OpenAPI specification](https://web-data-toolkit.vercel.app/openapi.json)
- [Subscribe and get a key on RapidAPI](https://rapidapi.com/leetanakung98/api/web-data-toolkit)

## Limits, stated plainly

Public data only, nothing behind a login. Transcripts are what the platform publishes, so auto-generated
captions carry the errors the machine made and the response says which kind you received. Google Trends numbers
are relative interest as Google reports them, not search volumes. An App Store reviews endpoint was offered
until 2026-09-14 and was withdrawn because Apple's public review feed stopped returning entries.