---
name: video-transcript-research
description: Pull and analyze transcripts of YouTube videos, TikToks, Instagram reels, X videos and LinkedIn videos - summarize, extract products, claims, quotes or hooks, and compare across many videos. Use when the user asks what a video or creator says, wants to search spoken content, or research a topic across videos. Uses the ScrapeIO API.
---

# Video transcript research

## Transcript endpoints (all take `url`)

| Platform | Tool or path | Credits |
| --- | --- | --- |
| YouTube | `youtube_transcript` (`/v1/youtube/video/transcript`, optional `language`) | 1 |
| TikTok | `tiktok_transcript` (`/v1/tiktok/video/transcript`) | 1 |
| Instagram reels under 2 minutes | `instagram_transcript` (`/v2/instagram/media/transcript`) | 2 |
| X | `/v1/twitter/tweet/transcript` | 1 |
| Facebook | `/v1/facebook/post/transcript` | 1 |
| LinkedIn | `/v1/linkedin/post/transcript` | 1 |

Videos without captions return no transcript and cost nothing.

## Steps

1. **Collect URLs.** Use the user's links, or list a creator's videos (`youtube_channel_videos`, `tiktok_profile_videos`, `instagram_user_reels`) or search (`youtube_search`, `tiktok_search_keyword`). Confirm the count before pulling more than 25.
2. **Pull transcripts** one by one. Keep `url`, `caption` and `created_at` with each.
3. **Analyze** for what the user asked: summary, products and brands mentioned, claims with timestamps, the hook (first 2 sentences), recurring topics across videos.
4. **Quote** short exact lines as evidence and link each video.

## Output

For one video: a summary, key points and quotes with timestamps. For many: a table (video, date, main topic, mentions) plus patterns across them. Say how many videos had no transcript.

## How to call ScrapeIO

Needs `SCRAPEIO_API_KEY`. If it is missing, ask the user to get a free key at https://scrapeio.com/login (100 credits, no card). Never print the key.

- **With the `scrapeio` MCP server:** use the named tool when it exists (for example `tiktok_profile`). For any other path, use `call_endpoint` with `{ "path": "/v1/...", "params": { ... } }`.
- **Without MCP:** `curl -s "https://scrapeio.com<path>?<params>" -H "x-api-key: $SCRAPEIO_API_KEY"`.
- Answers are in `data`; lists are `data.items` with `data.cursor` and `data.has_more`. Fields are the same on every platform: `handle`, `followers`, `plays`, `likes`, `comments`, `shares`, `created_at`, `url`.
- 403 (private) and 404 (not found) are free: skip and move on. Retry 502 once. 402 means the user needs credits (https://scrapeio.com/pricing).
- Watch `credits_remaining` and tell the user before a step would spend more than they expect.