YouTube Scraper

POST /api/youtube-scraper

Scrape video data from a YouTube channel or single video. Returns video metadata (title, views, likes, duration, thumbnails), with optional transcripts and comments. Async job — submit a request, then poll for results.

Request Body (JSON)

Name	Type	Required	Default	Description
url	string	Required	—	YouTube channel URL or video URL. Auto-detects single video vs. channel mode.
video_type	string	Optional	both	Type of videos to scrape: `shorts`, `videos`, or `both`
sort	string	Optional	recent	Sort order: `recent` or `popular`
max_videos	integer	Optional	20	Maximum videos to scrape (1–100)
include_transcripts	boolean	Optional	false	Include full video transcripts in the response
include_comments	boolean	Optional	false	Include top comments for each video

Example Request

# Scrape a channel's most popular videos with transcripts curl -X POST "https://api.algrow.online/api/youtube-scraper" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "url": "https://www.youtube.com/@MrBeast", "video_type": "videos", "sort": "popular", "max_videos": 10, "include_transcripts": true }'

Response 200 200

{
                  "success": true,
                  "job_id": 4521,
                  "mode": "channel",
                  "message": "Scraping job queued. Poll /api/youtube-scraper/{job_id} for results."
                }

200 Queued 400 Invalid URL 401 Auth failed 403 Pro/Ultimate required

GET /api/youtube-scraper/:job_id

Poll for the result of a YouTube scraping job. Returns pending or processing while running, and the full video data when completed.

Example Request

curl "https://api.algrow.online/api/youtube-scraper/4521" \ -H "Authorization: Bearer YOUR_API_KEY"

Completed Response 200 200

{
                  "success": true,
                  "job_id": 4521,
                  "status": "completed",
                  "created_at": "2026-03-24T10:30:00",
                  "completed_at": "2026-03-24T10:31:15",
                  "result": {
                    "total_videos": 10,
                    "total_views": 1250000000,
                    "total_likes": 42000000,
                    "videos": [
                      {
                        "video_id": "dQw4w9WgXcQ",
                        "title": "Video Title Here",
                        "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
                        "thumbnail": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg",
                        "view_count": 250000000,
                        "like_count": 8500000,
                        "comment_count": 2100000,
                        "duration_seconds": 212,
                        "duration_human": "3m 32s",
                        "publish_date": "2025-10-15T14:00:00Z",
                        "channel": "MrBeast",
                        "channel_id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
                        "transcript_url": "https://audio.algrow.online/api/transcripts/a1b2c3d4e5f6_Video_Title.txt",
                        "comments": [
                          {
                            "author": "@user123",
                            "text": "Great video!",
                            "likes": 5200,
                            "published_time": "2 months ago"
                          }
                        ]
                      }
                    ]
                  }
                }

Response Fields (per video)

Field	Type	Description
video_id	string	YouTube video ID
title	string	Video title
url	string	Full YouTube URL
thumbnail	string	Thumbnail image URL (highest resolution available)
view_count	integer	Total views
like_count	integer	Total likes
comment_count	integer	Total comments
duration_seconds	integer	Video length in seconds
duration_human	string	Human-readable duration (e.g. “3m 32s”)
publish_date	string	Publish date (ISO 8601)
channel	string	Channel name
channel_id	string	YouTube channel ID
transcript_url	string\|null	URL to the full transcript text file hosted on R2 (only if `include_transcripts: true`)
comments	array\|null	Top comments (only if `include_comments: true`)

200 Success 401 Auth failed 404 Job not found

POST /api/youtube-scraper-fast

Synchronous YouTube channel scrape via the Data API v3 — no job queue, no polling. Returns channel metadata + videos (and optional comments) inline in ~2–5s, the same shape as the queued /api/youtube-scraper result. Transcripts are NOT supported here (use the queued endpoint for those).

Request Body (JSON)

Name	Type	Required	Default	Description
url	string	Required	—	A YouTube channel URL (youtube.com or youtu.be).
video_type	string	Optional	both	shorts, videos, or both.
sort	string	Optional	recent	recent or popular.
max_videos	integer	Optional	20	1–100.
include_comments	boolean	Optional	false	Include top comments per video.
max_comments	integer	Optional	100	1–100, when include_comments is true.

Example Request

curl -X POST "https://api.algrow.online/api/youtube-scraper-fast" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"url": "https://youtube.com/@MrBeast", "video_type": "videos", "max_videos": 20}'

Response 200 200

{
                  "success": true,
                  "status": "completed",
                  "result": { … channel + videos … }
                }

200 Success 400 Validation error 401 Auth failed 503 Quota exhausted

Buy More Credits