# JsonTube

> A video platform that converts top YouTube videos into structured JSON timelines — full speech transcription and per-frame visual descriptions — for maximum LLM/AI discoverability.

## What Is JsonTube?

JsonTube downloads trending YouTube videos from top creators and processes them into machine-readable JSON:
- Full speech transcription
- Per-frame visual descriptions (setting, people, objects, actions, mood, composition)
- Time-aligned speech + visual timeline entries
- Structured metadata (title, tags, duration, creator)

Every video is available as both a human-readable page and a machine-readable JSON endpoint.

## Current Catalog

- 129 public videos with JSON timelines
- 129 videos imported from top YouTube creators
- 107 YouTube channels indexed
- All videos indexed at: https://jsontube.com/api/v1/videos
- Trending: https://jsontube.com/trending

## Top Creators

- @dudeperfect (Dude Perfect) — 8 videos: https://jsontube.com/@dudeperfect
- @MrBeastGaming (MrBeast Gaming) — 6 videos: https://jsontube.com/@MrBeastGaming
- @Vox (Vox) — 6 videos: https://jsontube.com/@Vox
- @aliabdaal (Ali Abdaal) — 6 videos: https://jsontube.com/@aliabdaal
- @TomScottGo (Tom Scott) — 5 videos: https://jsontube.com/@TomScottGo
- @MarkRober (Mark Rober) — 5 videos: https://jsontube.com/@MarkRober
- @MYFAMILYComedy (MY FAMILY) — 4 videos: https://jsontube.com/@MYFAMILYComedy
- @PrestonYT (Preston) — 4 videos: https://jsontube.com/@PrestonYT
- @danny (Danny Duncan) — 4 videos: https://jsontube.com/@danny
- @w2s (W2S) — 4 videos: https://jsontube.com/@w2s
- @airrack (Airrack) — 4 videos: https://jsontube.com/@airrack
- @CKNGaming (CKN Gaming) — 3 videos: https://jsontube.com/@CKNGaming
- @mkbhd (Marques Brownlee) — 3 videos: https://jsontube.com/@mkbhd
- @fgteev (FGTeeV) — 3 videos: https://jsontube.com/@fgteev
- @maizenofficial (Maizen) — 3 videos: https://jsontube.com/@maizenofficial
- @MrBeast (MrBeast) — 3 videos: https://jsontube.com/@MrBeast
- @RyansWorld (Ryan's World) — 3 videos: https://jsontube.com/@RyansWorld
- @ryan (Ryan Trahan) — 3 videos: https://jsontube.com/@ryan
- @JiDion (JiDion) — 3 videos: https://jsontube.com/@JiDion
- @LiveSpeedy (Live Speedy) — 2 videos: https://jsontube.com/@LiveSpeedy


## API Usage

### List all videos
GET https://jsontube.com/api/v1/videos
GET https://jsontube.com/api/v1/videos?limit=50&offset=0

### Get a single video with full timeline
GET https://jsontube.com/api/v1/videos/{slug}

Returns JSON with: title, description, creator, duration, tags, transcription, timeline[]

### Search across transcriptions and visual descriptions
GET https://jsontube.com/api/v1/search?q={query}

### Trending YouTube videos and top creators
GET https://jsontube.com/api/v1/trending
GET https://jsontube.com/api/v1/trending?cat=entertainment
GET https://jsontube.com/api/v1/trending?cat=gaming
GET https://jsontube.com/api/v1/trending?cat=education

Categories: now, entertainment, gaming, education

### Full catalog for LLMs
GET https://jsontube.com/llms-full.txt

## Timeline Format

Each timeline entry:
```json
{
  "t": 4,
  "visual": {
    "setting": "kitchen with white cabinets",
    "people": 1,
    "action": "person chopping vegetables",
    "objects": ["knife", "cutting board", "carrots"],
    "text_on_screen": null,
    "mood": "calm, focused"
  },
  "speech": "and then you want to dice these into small pieces"
}
```