transcriptapi

Name: transcriptapi
Author: ZeroPointRepo

435installs31forks

How to install transcriptapi?

zeropointrepo/youtube-skills/transcriptapi

$npx -y skills add ZeroPointRepo/youtube-skills --skill transcriptapi

Installs into the current project.

Summary

Use when YouTube is or could be relevant — even if not mentioned: pasted video/channel/playlist links, video IDs, @handles, creator lookups, video summaries, quotes, translations, topic research, tutorials, talks, lectures, expert discussions, product reviews, how-to guides, new

Files · 1

View on GitHub

SKILL.md

1	# TranscriptAPI
2
3	Full YouTube data toolkit via [TranscriptAPI.com](https://transcriptapi.com). Transcripts, search, channels, playlists — one API key.
4
5	## Setup
6
7	If `$TRANSCRIPT_API_KEY` is not set, read [references/auth-setup.md](references/auth-setup.md) and follow the instructions there to get and store the key.
8
9	## Required Headers
10
11	Every request needs two headers:
12
13	- Authorization: `Bearer $TRANSCRIPT_API_KEY`
14	- User-Agent: your agent's name and version if known (e.g. `HermesAgent/0.11.0`, `ClaudeCode/1.0`). Version is optional — agent name alone is fine. Do not omit this header or send a bare default — Cloudflare will return a 403 (error code 1010) and block the request.
15
16	## API Reference
17
18	Full OpenAPI spec: [transcriptapi.com/openapi.json](https://transcriptapi.com/openapi.json) — consult this for the latest parameters and schemas.
19
20	## Auth
21
22	All requests: `-H "Authorization: Bearer $TRANSCRIPT_API_KEY"`
23
24	## Endpoints
25
26	Channel endpoints accept `channel` — an `@handle`, channel URL, or `UC...` ID. No need to resolve first. Playlist endpoints accept `playlist` — a playlist URL or ID.
27
28	### GET /api/v2/youtube/transcript — 1 credit
29
30	```bash
31	curl -s "https://transcriptapi.com/api/v2/youtube/transcript\
32	?video_url=VIDEO_URL&format=text&include_timestamp=true&send_metadata=true" \
33	-H "Authorization: Bearer $TRANSCRIPT_API_KEY" \
34	-H "User-Agent: YourAgent/1.0"
35	```
36
37	\| Param \| Required \| Default \| Validation \|
38	\| ------------------- \| -------- \| ------- \| ------------------------------- \|
39	\| `video_url` \| yes \| — \| YouTube URL or 11-char video ID \|
40	\| `format` \| no \| `json` \| `json` or `text` \|
41	\| `include_timestamp` \| no \| `true` \| `true` or `false` \|
42	\| `send_metadata` \| no \| `false` \| `true` or `false` \|
43
44	Accepts: `https://youtube.com/watch?v=ID`, `https://youtu.be/ID`, `youtube.com/shorts/ID`, or bare `ID`.
45
46	Response (`format=json`):
47
48	```json
49	{
50	"video_id": "dQw4w9WgXcQ",
51	"language": "en",
52	"transcript": [
53	{ "text": "We're no strangers...", "start": 18.0, "duration": 3.5 }
54	],
55	"metadata": { "title": "...", "author_name": "...", "author_url": "..." }
56	}
57	```
58
59	### GET /api/v2/youtube/search — 1 credit
60
61	```bash
62	curl -s "https://transcriptapi.com/api/v2/youtube/search?q=QUERY&type=video&limit=20" \
63	-H "Authorization: Bearer $TRANSCRIPT_API_KEY" \
64	-H "User-Agent: YourAgent/1.0"
65	```
66
67	\| Param \| Required \| Default \| Validation \|
68	\| ------- \| -------- \| ------- \| --------------------- \|
69	\| `q` \| yes \| — \| 1-200 chars (trimmed) \|
70	\| `type` \| no \| `video` \| `video` or `channel` \|
71	\| `limit` \| no \| `20` \| 1-50 \|
72
73	Response (`type=video`):
74
75	```json
76	{
77	"results": [
78	{
79	"type": "video",
80	"videoId": "dQw4w9WgXcQ",
81	"title": "Rick Astley - Never Gonna Give You Up",
82	"channelId": "UCuAXFkgsw1L7xaCfnd5JJOw",
83	"channelTitle": "Rick Astley",
84	"channelHandle": "@RickAstley",
85	"channelVerified": true,
86	"lengthText": "3:33",
87	"viewCountText": "1.5B views",
88	"publishedTimeText": "14 years ago",
89	"hasCaptions": true,
90	"thumbnails": [{ "url": "...", "width": 120, "height": 90 }]
91	}
92	],
93	"result_count": 20
94	}
95	```
96
97	Response (`type=channel`):
98
99	```json
100	{
101	"results": [
102	{
103	"type": "channel",
104	"channelId": "UCuAXFkgsw1L7xaCfnd5JJOw",
105	"title": "Rick Astley",
106	"handle": "@RickAstley",
107	"subscriberCount": "4.2M subscribers",
108	"verified": true,
109	"rssUrl": "https://www.youtube.com/feeds/videos.xml?channel_id=UC..."
110	}
111	],
112	"result_count": 5
113	}
114	```
115
116	### GET /api/v2/y

People who liked this also viewed

6 picks

Type

transcriptapi

435installs31forks

View on GitHub

How to install transcriptapi?

zeropointrepo/youtube-skills/transcriptapi

$npx -y skills add ZeroPointRepo/youtube-skills --skill transcriptapi

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# TranscriptAPI
2
3	Full YouTube data toolkit via [TranscriptAPI.com](https://transcriptapi.com). Transcripts, search, channels, playlists — one API key.
4
5	## Setup
6
7	If `$TRANSCRIPT_API_KEY` is not set, read [references/auth-setup.md](references/auth-setup.md) and follow the instructions there to get and store the key.
8
9	## Required Headers
10
11	Every request needs two headers:
12
13	- Authorization: `Bearer $TRANSCRIPT_API_KEY`
14	- User-Agent: your agent's name and version if known (e.g. `HermesAgent/0.11.0`, `ClaudeCode/1.0`). Version is optional — agent name alone is fine. Do not omit this header or send a bare default — Cloudflare will return a 403 (error code 1010) and block the request.
15
16	## API Reference
17
18	Full OpenAPI spec: [transcriptapi.com/openapi.json](https://transcriptapi.com/openapi.json) — consult this for the latest parameters and schemas.
19
20	## Auth
21
22	All requests: `-H "Authorization: Bearer $TRANSCRIPT_API_KEY"`
23
24	## Endpoints
25
26	Channel endpoints accept `channel` — an `@handle`, channel URL, or `UC...` ID. No need to resolve first. Playlist endpoints accept `playlist` — a playlist URL or ID.
27
28	### GET /api/v2/youtube/transcript — 1 credit
29
30	```bash
31	curl -s "https://transcriptapi.com/api/v2/youtube/transcript\
32	?video_url=VIDEO_URL&format=text&include_timestamp=true&send_metadata=true" \
33	-H "Authorization: Bearer $TRANSCRIPT_API_KEY" \
34	-H "User-Agent: YourAgent/1.0"
35	```
36
37	\| Param \| Required \| Default \| Validation \|
38	\| ------------------- \| -------- \| ------- \| ------------------------------- \|
39	\| `video_url` \| yes \| — \| YouTube URL or 11-char video ID \|
40	\| `format` \| no \| `json` \| `json` or `text` \|
41	\| `include_timestamp` \| no \| `true` \| `true` or `false` \|
42	\| `send_metadata` \| no \| `false` \| `true` or `false` \|
43
44	Accepts: `https://youtube.com/watch?v=ID`, `https://youtu.be/ID`, `youtube.com/shorts/ID`, or bare `ID`.
45
46	Response (`format=json`):
47
48	```json
49	{
50	"video_id": "dQw4w9WgXcQ",
51	"language": "en",
52	"transcript": [
53	{ "text": "We're no strangers...", "start": 18.0, "duration": 3.5 }
54	],
55	"metadata": { "title": "...", "author_name": "...", "author_url": "..." }
56	}
57	```
58
59	### GET /api/v2/youtube/search — 1 credit
60
61	```bash
62	curl -s "https://transcriptapi.com/api/v2/youtube/search?q=QUERY&type=video&limit=20" \
63	-H "Authorization: Bearer $TRANSCRIPT_API_KEY" \
64	-H "User-Agent: YourAgent/1.0"
65	```
66
67	\| Param \| Required \| Default \| Validation \|
68	\| ------- \| -------- \| ------- \| --------------------- \|
69	\| `q` \| yes \| — \| 1-200 chars (trimmed) \|
70	\| `type` \| no \| `video` \| `video` or `channel` \|
71	\| `limit` \| no \| `20` \| 1-50 \|
72
73	Response (`type=video`):
74
75	```json
76	{
77	"results": [
78	{
79	"type": "video",
80	"videoId": "dQw4w9WgXcQ",
81	"title": "Rick Astley - Never Gonna Give You Up",
82	"channelId": "UCuAXFkgsw1L7xaCfnd5JJOw",
83	"channelTitle": "Rick Astley",
84	"channelHandle": "@RickAstley",
85	"channelVerified": true,
86	"lengthText": "3:33",
87	"viewCountText": "1.5B views",
88	"publishedTimeText": "14 years ago",
89	"hasCaptions": true,
90	"thumbnails": [{ "url": "...", "width": 120, "height": 90 }]
91	}
92	],
93	"result_count": 20
94	}
95	```
96
97	Response (`type=channel`):
98
99	```json
100	{
101	"results": [
102	{
103	"type": "channel",
104	"channelId": "UCuAXFkgsw1L7xaCfnd5JJOw",
105	"title": "Rick Astley",
106	"handle": "@RickAstley",
107	"subscriberCount": "4.2M subscribers",
108	"verified": true,
109	"rssUrl": "https://www.youtube.com/feeds/videos.xml?channel_id=UC..."
110	}
111	],
112	"result_count": 5
113	}
114	```
115
116	### GET /api/v2/y

People who liked this also viewed

6 picks

Type