youtube-research

stars:0
forks:1
watches:0
last updated:2026-08-10 07:51:26

YouTube research

Resolve YouTube videos and channels, and pull transcripts, comments, playlists, and search results as normalized JSON from the Crawlora API — no yt-dlp, no browser, no scraping.

When to use this skill

  • The user pastes a YouTube URL and wants its transcript, summary, or stats.
  • "Get the comments on this video" / "what are people saying?"
  • "List this channel's recent videos / shorts / playlists."
  • "Search YouTube for …" or "what videos exist about …".
  • Building a transcript-based summary, sentiment, or research pipeline.

Setup (one-time)

  • Get a free Crawlora API key (2,000 credits/mo, no card) at https://crawlora.net.
  • export CRAWLORA_API_KEY=sk_your_key_here
  • All requests: x-api-key: $CRAWLORA_API_KEY against https://api.crawlora.net/api/v1. Missing/invalid key → 401.

How it works

  1. Resolve the id. A YouTube watch URL https://www.youtube.com/watch?v=<ID> (or https://youtu.be/<ID>) gives the video id; channel URLs give a channel id. Extract the id before calling.
  2. Transcript: /youtube/transcript/{id} (use /youtube/transcript/{id}/languages first if you need a specific language).
  3. Metadata / comments: /youtube/video/{id}, /youtube/comments/{id}.
  4. Channel: /youtube/channel/{id}/videos, /channel/{id}/shorts, /channel/{id}/playlists, /youtube/profile/{id}.
  5. Discovery: /youtube/search?q=... to find videos by keyword.

Full endpoint list, methods, and params: reference/endpoints.md.

Calling the API

# Transcript for a video id (GET):
scripts/crawlora.sh /youtube/transcript/dQw4w9WgXcQ | jq '.'

# Video metadata + comments:
scripts/crawlora.sh /youtube/video/dQw4w9WgXcQ | jq '{title,views,channel}'
scripts/crawlora.sh /youtube/comments/dQw4w9WgXcQ | jq '.comments[].text'

# Search:
scripts/crawlora.sh /youtube/search q="web scraping tutorial" | jq '.'

Raw curl fallback:

curl -fsS -H "x-api-key: $CRAWLORA_API_KEY" \
  "https://api.crawlora.net/api/v1/youtube/transcript/dQw4w9WgXcQ" | jq '.'

Endpoint reference

See reference/endpoints.md for every YouTube endpoint this skill uses (method, path, params, description).

Examples

  • Summarize a video: extract the id from the URL → /youtube/transcript/{id} → concatenate transcript segments → summarize.
  • Comment sentiment: /youtube/comments/{id} → bucket comments by sentiment and surface common themes.
  • Channel digest: /youtube/channel/{id}/videos → list recent uploads with view counts and publish dates.

Notes & limits

  • Credits / pay-on-success: billed only on 2xx; free tier 2,000 credits/mo. Key at https://crawlora.net.
  • Public data only — public YouTube pages; respect YouTube's terms.
  • Security: key lives in CRAWLORA_API_KEY only — never hardcode, query-param, or commit it.
  • Not every video has captions; check /youtube/transcript/{id}/languages when a transcript request returns empty.
Good AI Tools