Docs

YouTube Search

Search YouTube directly for videos, channels, and playlists.

Search YouTube directly for videos, channels, and playlists. Returns a mixed-type result list where each item carries a type discriminator. Supports sort_by=view_count, fine-grained upload_date buckets, and a custom published_within_days filter.

GET/api/search

Search everything on YouTube in one call — videos, channels, and playlists in the same result list, each tagged with its type.

Query Parameters

Name	Type	Required	Default	Description
q	string	Required	—	Search query.
type	string	Optional	all	`all`, `video`, `channel`, `playlist`, `movie`.
sort_by	string	Optional	relevance	`relevance`, `view_count`, `upload_date`, `rating`.
upload_date	string	Optional	all	`all`, `hour`, `today`, `week`, `month`, `year`.
duration	string	Optional	all	`short` (<4m), `medium` (4–20m), `long` (>20m). Videos only.
published_within_days	integer	Optional	—	Narrow videos to those posted in the last N days. Finer than `upload_date` — use for phrasings like “last 3 days”. Auto-picks the tightest native bucket, fetches a larger batch, and post-filters.
limit	integer	Optional	30	Max results (1–100).

200 Success 401 Auth failed 500 Server error

Example Response

{
  "success": true,
  "query": "the rise and fall",
  "limit": 20,
  "estimated_results": 1421503,
  "count": 20,
  "has_more": true,
  "results": [
    {
      "type": "video",
      "video_id": "uSCHW7vAq-s",
      "title": "The Rise and Fall of America's Most Infamous Detective Agency",
      "url": "https://www.youtube.com/watch?v=uSCHW7vAq-s",
      "channel_name": "Wendigang",
      "channel_id": "UCxxxxxxxxxxxxxxxxxxxxxx",
      "published_text": "2 days ago",
      "duration_text": "49:50",
      "duration_seconds": 2990,
      "view_count": 381848,
      "view_count_text": "381,848 views",
      "thumbnail_url": "https://i.ytimg.com/vi/uSCHW7vAq-s/hq720.jpg",
      "description_snippet": "..."
    },
    {
      "type": "channel",
      "channel_id": "UCnwUjPK7dXety-AJ4fNw_RQ",
      "name": "The Paint Explainer",
      "handle": "@ThePaintExplainer",
      "url": "https://www.youtube.com/channel/UCnwUjPK7dXety-AJ4fNw_RQ",
      "subscriber_count": 1840000,
      "subscriber_count_text": "1.84M subscribers",
      "description_snippet": "...",
      "thumbnail_url": "..."
    },
    {
      "type": "playlist",
      "playlist_id": "PLbdSi72ah3puMBGa4eLQMNKn4OqaVPsHF",
      "title": "All Casually Explained",
      "url": "https://www.youtube.com/playlist?list=PLbdSi72ah3puMBGa4eLQMNKn4OqaVPsHF",
      "channel_name": "Casually Explained",
      "channel_id": "UCr3cBLTYmIK9kY0F_OdFWFQ",
      "video_count": 85,
      "video_count_text": "85 videos",
      "thumbnail_url": "..."
    }
  ]
}

Example Request

# Top-viewed "rise and fall" videos posted in the last 3 days
curl -G "https://algrow.online/api/search" \
  -H "Authorization: Bearer algrow_..." \
  --data-urlencode "q=the rise and fall" \
  -d "type=video&sort_by=view_count&published_within_days=3&limit=20"

PreviousAnalysis Tools NextChannel Data