Bulk Discovery

Read YouTube live, in bulk, without spending your own API quota — peek at thousands of channels at once, sweep a topic to see who occupies it, and pull the top comments off a batch of videos. These endpoints go straight to YouTube rather than the Algrow index, so brand-new channels and videos are covered.

POST /api/channel-peek

First look at up to 2,000 channels in one call — name, subscriber count, best-performing view count, and recent + popular video titles for each. Reads YouTube directly rather than the Algrow index, so brand-new channels are covered and no YouTube Data API quota is spent. Free.

Request Body (JSON)

Name	Type	Required	Default	Description
channel_ids	array	Required	—	Channel IDs (`UC...`). Max 2,000 per request; extras are dropped. Send pools larger than that in chunks of roughly 1,200 to stay inside the 280s timeout.
per_sort	integer	Optional	15	Videos to return per sort order (recent and popular). Max 30.
concurrency	integer	Optional	12	Channels fetched in parallel. Max 16.

Example Request

curl -X POST "https://api.algrow.online/api/channel-peek" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"channel_ids": ["UCX6OQ3DkcsbYNE6H8uQQuVA", "UCsXVk37bltHxD1rDPwtNM8Q"], "per_sort": 10}'

Example Response

{
                  "success": true,
                  "requested": 2,
                  "channels": [
                    {
                      "channel_id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
                      "name": "MrBeast",
                      "subs": 634000000,
                      "ceiling": 812443210,
                      "videos": [
                        {"video_id": "abc123", "title": "I Survived 50 Hours In Antarctica", "views": 128443210, "sort": "popular"}
                      ]
                    }
                  ]
                }

Timeouts. The request runs synchronously and is cut off at 280 seconds, which returns 504 with a message to send fewer channels. Size each batch so it finishes well inside that.

200 Success 400 Validation error 401 Auth failed 502 Peek failed 503 Peek unavailable 504 Timed out — send fewer channels

POST /api/room-sweep

Run live paginated YouTube searches across a set of broad topic terms and rank every channel that shows up by how often it appears. Channels that recur across terms sit at the top; a giant that one generic term dragged in appears once and sinks. Use it to map who actually occupies a topic before you commit to it. Free.

Request Body (JSON)

Name	Type	Required	Default	Description
terms	array	Required	—	Topic terms to sweep, e.g. `["mountain men", "frontier survival"]`. Only the first 16 are used; the rest come back in `terms_dropped`.
pages	integer	Optional	10	Result pages per term per result type. Max 10.

Example Request

curl -X POST "https://api.algrow.online/api/room-sweep" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"terms": ["mountain men", "frontier survival"], "pages": 5}'

Example Response

{
                  "success": true,
                  "partial": false,
                  "channels": [
                    {"channel_id": "UCabc123", "title": "Frontier Life", "centrality": 34},
                    {"channel_id": "UCdef456", "title": "Wild Homestead", "centrality": 11}
                  ],
                  "terms_used": ["mountain men", "frontier survival"],
                  "terms_dropped": [],
                  "max_terms": 16
                }

Always read partial and terms_dropped. partial: true means the search quota ran out mid-sweep, and a non-empty terms_dropped means you sent more than 16 terms. Either one means the channel list is incomplete — re-run the missing terms rather than treating it as a full picture.

200 Success 400 Validation error 401 Auth failed

POST /api/video-comments

Top-liked comments for a batch of videos, sorted by like count. Videos with comments turned off are skipped instead of failing the batch. Free.

Request Body (JSON)

Name	Type	Required	Default	Description
video_ids	array	Required	—	YouTube video IDs. Max 25 per request; extras are dropped.
max_per_video	integer	Optional	60	Comments to return per video. Max 100.
order	string	Optional	relevance	`relevance` or `time`. Anything else falls back to `relevance`.

Example Request

curl -X POST "https://api.algrow.online/api/video-comments" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"video_ids": ["dQw4w9WgXcQ"], "max_per_video": 25}'

Example Response

{
                  "success": true,
                  "comments": {
                    "dQw4w9WgXcQ": [
                      {"text": "the edit at 3:12 is unreal", "likes": 4821}
                    ]
                  }
                }

200 Success 400 Validation error 401 Auth failed

Buy More Credits