Algrow
Shorts Channels
Analysis Tools
Monetization checks, video analysis, and terminated-channel search.
GET
/api/channel-monetization/:channel_id
Full monetization profile for one channel — what it sells, each method with its own evidence + source link, products, and store URLs. If the channel isn't classified yet it runs the classifier live (≤60s) and persists the result; pass ?skip_live=true to skip that and get an immediate unclassified response.
Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| channel_id | string | Required | YouTube channel id (UC…, 24 chars). Use /api/channels/resolve for handles/URLs. |
Query Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| skip_live | boolean | Optional | false | Skip the live classifier and return immediately (classified:false if not already known). |
Example Request
curl "https://api.algrow.online/api/channel-monetization/UCX6OQ3DkcsbYNE6H8uQQuVA" \
-H "Authorization: Bearer YOUR_API_KEY"
200 Success
401 Auth failed
POST
/api/analyze-video
Analyze a YouTube video with AI vision — hooks, pacing, visual storytelling, on-screen text, B-roll usage, content strategy, and any other prompt-driven breakdown. Returns structured analysis text. Currently free during preview — no credit cost, no plan requirement — only an API key and the per-user concurrency cap apply. Repeat prompts on the same video within 2 hours reuse a cached upload automatically (faster on the backend, returns cached: true).
Request Body (JSON)
| Name | Type | Required | Description |
|---|---|---|---|
| video_url | string | Required | YouTube video URL. Accepts watch links, youtu.be short links, and Shorts URLs. |
| prompt | string | Required | Plain-English instruction describing what to analyze. Max 4,000 characters. |
| media_resolution | string | Optional | Analysis fidelity: low (default, recommended for hook / pacing / strategy prompts) or default (higher visual detail at greater backend cost — useful when fine on-screen text or subtle visual cues matter). |
Limits: Maximum video length is 3 hours. Live streams, private, deleted, and age-restricted videos are rejected with clear error messages. Concurrency cap applies (5 / 10 / 20 active jobs by tier).
Example Request (Hook breakdown)
curl -X POST "https://api.algrow.online/api/analyze-video" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"video_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"prompt": "Break down the hook in the first 3 seconds. What grabs attention?",
"media_resolution": "low"
}'
Example Request (Pacing analysis on a Short)
curl -X POST "https://api.algrow.online/api/analyze-video" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"video_url": "https://youtube.com/shorts/abc123XYZ",
"prompt": "Identify the pacing, energy shifts, on-screen text timing, and where attention is most likely to drop."
}'
Response 200 200
{
"success": true,
"job_id": "f12d4a8b-2e1f-44e1-9aa1-2dfa20c5c7d3",
"status": "pending",
"duration_seconds": 187.4,
"message": "Video analysis queued. Poll /api/job-status/{job_id} for progress."
}
Completed Job Response (via /api/job-status/:job_id)
{
"success": true,
"job_id": "f12d4a8b-2e1f-44e1-9aa1-2dfa20c5c7d3",
"job_type": "video_analysis",
"status": "completed",
"analysis_text": "The opening 3 seconds use a hard cut from black to a wide shot of...",
"duration_seconds": 187.4,
"video_id": "dQw4w9WgXcQ",
"cached": false,
"completed_at": 1774203012.45
}
Processing time: Typically 5–25 seconds for Shorts, 30–90 seconds for 5-minute videos, several minutes for hour-long content. The first analysis on a video is slower than follow-up prompts on the same video (which hit the cache and skip download + upload). Poll
/api/job-status/:job_id every 5 seconds for updates.Caching: When you run multiple prompts on the same
video_url within 2 hours, the source video is reused from cache — the response includes cached: true. Cache is keyed per (user, video) so each user pays the cold-path cost once per video per 2 hours.
200 Queued
400 Validation / unsupported video
401 Auth failed
429 Concurrency cap
GET
/api/terminated-channels/search
Search terminated/deleted YouTube channels. Returns channel metadata, growth metrics at time of termination, and up to 3 top videos per channel. Supports keyword matching and advanced filters. Available on all plans.
Query Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| q | string | Required | — | Search query. Matches against channel titles and video titles. Comma-separated for multiple keywords. |
| languages | string | Optional | — | Filter by language. Comma-separated (e.g. English,Spanish) |
| sort | string | Optional | date_desc | Sort field and direction. Format: {field}_{asc|desc}. Fields: subs, views, videos, age, views_24h, subs_24h, views_48h, date, similarity (when using q) |
| page | integer | Optional | 1 | Page number (1-indexed, max 20) |
| per_page | integer | Optional | 20 | Results per page (max 50) |
| min_subs | integer | Optional | — | Minimum subscriber count |
| max_subs | integer | Optional | — | Maximum subscriber count |
| min_views | integer | Optional | — | Minimum total view count |
| max_views | integer | Optional | — | Maximum total view count |
| min_avg_views | integer | Optional | — | Minimum average views per video |
| max_avg_views | integer | Optional | — | Maximum average views per video |
| min_age | integer | Optional | — | Minimum channel age in days |
| max_age | integer | Optional | — | Maximum channel age in days |
| min_uploads | integer | Optional | — | Minimum number of videos |
| max_uploads | integer | Optional | — | Maximum number of videos |
| monetized | string | Optional | — | Filter by monetization status: yes or no |
| min_views_24h | integer | Optional | — | Minimum views gained in last 24h before termination |
| max_views_24h | integer | Optional | — | Maximum views gained in last 24h before termination |
| min_views_48h | integer | Optional | — | Minimum views gained in last 48h before termination |
| max_views_48h | integer | Optional | — | Maximum views gained in last 48h before termination |
Example Requests
# Search for terminated gaming channels
curl "https://api.algrow.online/api/terminated-channels/search?q=gaming&languages=English&per_page=10" \
-H "Authorization: Bearer YOUR_API_KEY"
# High-sub terminated gaming channels sorted by subscribers
curl "https://api.algrow.online/api/terminated-channels/search?q=gaming&min_subs=100000&sort=subs_desc" \
-H "Authorization: Bearer YOUR_API_KEY"
# Recently terminated motivation channels
curl "https://api.algrow.online/api/terminated-channels/search?q=motivation&sort=date_desc&per_page=20" \
-H "Authorization: Bearer YOUR_API_KEY"
Response 200 200
{
"success": true,
"page": 1,
"per_page": 20,
"count": 20,
"channels": [
{
"channel_id": "UCxxxxxxxxxxxxxxxxxxxxxx",
"channel_title": "Deleted Gaming Channel",
"subscriber_count": 340000,
"view_count": 95000000,
"avg_views_per_video": 2100000,
"total_videos": 45,
"primary_language": "English",
"monetized": true,
"is_low_quality": false,
"thumbnail_url": "https://yt3.ggpht.com/...",
"first_upload_date": "2025-06-12",
"terminated_date": "2026-03-10",
"terminated_days_ago": 15,
"view_increase_24h": 120000,
"sub_increase_24h": 800,
"view_increase_48h": 210000,
"sub_increase_48h": 1400,
"similarity_score": 85,
"recent_videos": [
{
"video_id": "abc123",
"title": "Most Viewed Video Title",
"view_count": 12000000,
"thumbnail_url": "https://audio.algrow.online/thumbnails/...",
"url": "https://www.youtube.com/watch?v=abc123"
}
]
}
]
}
Response Fields
| Field | Type | Description |
|---|---|---|
| channel_id | string | YouTube channel ID |
| channel_title | string | Channel name at time of termination |
| subscriber_count | integer | Subscriber count at termination |
| view_count | integer | Total channel views at termination |
| avg_views_per_video | integer | Average views per video |
| total_videos | integer | Number of videos on the channel |
| primary_language | string | Detected content language |
| monetized | boolean | Whether the channel was monetized |
| is_low_quality | boolean | Whether the channel was flagged as low quality |
| thumbnail_url | string | Channel profile picture URL |
| first_upload_date | string | Date of the channel's first upload (ISO 8601) |
| terminated_date | string | Date the channel was terminated (ISO 8601) |
| terminated_days_ago | integer | Days since the channel was terminated |
| view_increase_24h | integer|null | Views gained in last 24h before termination |
| sub_increase_24h | integer|null | Subscribers gained in last 24h before termination |
| view_increase_48h | integer|null | Views gained in last 48h before termination |
| sub_increase_48h | integer|null | Subscribers gained in last 48h before termination |
| similarity_score | integer|null | Similarity score (0–100) when using q search |
| recent_videos | array | Top 3 videos by views with video_id, title, view_count, thumbnail_url, url |
200 Success
401 Auth failed
403 Pro/Ultimate required
500 Server error