YouTube Search Scraper

Run a keyword search on YouTube and export structured rows for videos, channels, playlists, and other supported result kinds. Narrow results with region and language hints, length and upload-time filters, optional feature tags, and a sort order. The actor follows the platform’s continuation flow so you can collect more than a single page—up to the limit you set.

Who it’s for

• Researchers and analysts who need searchable snapshots in table form.
• Creators tracking topics, competitors, or niches.
• Automation that runs scheduled searches with consistent filters.

What you can do with it

• Search with any query text.
• Bias results with an optional region and language hint.
• Choose what to return: videos, channels, playlists, movies, shows, or shorts.
• Filter by rough duration, upload recency, and optional feature keywords.
• Sort by relevance, rating, date, or views where applicable.
• Optionally ask for more localized metadata when combined with a region.
• Cap total rows so runs stay predictable.

How it works (in plain terms)

You provide a query and optional filters. The actor requests the first page of results, saves rows until your cap, then automatically requests additional pages using the continuation token returned by the service, pausing briefly between requests. You do not paste tokens yourself.

Input

Field	Required	What it means
Search query (searchQuery)	Yes	Keywords or phrases to search for.
Region (region)	No	Country or region code to bias results (e.g. US, GB).
Language hint (language)	No	Locale or language preference (e.g. en).
Result kind (resultType)	No	Videos (default), channels, playlists, movies, shows, or shorts.
Video length (duration)	No	Any, short, medium, or long (for types where length applies).
Features (features)	No	Optional comma-separated feature tags when you need extra constraints.
Upload time (uploadDate)	No	Restrict to recent uploads (hour through year) or any time.
Sort order (sortBy)	No	Relevance (default), rating, upload date, or view count.
Prefer localized listings (preferLocalized)	No	Request localized metadata; pair with a region when possible.
Maximum results (maxResults)	No	Upper bound on rows to collect across pages (default 100).

Some combinations are limited by the product (for example, certain sort options may not apply to shorts). If a run returns fewer rows than your cap, the list may be exhausted or filters may be tight.

Output

• One row per item (until your cap). Duplicates across pages are skipped when the same stable id is seen again (videoId, playlistId, channelId, or similar).
• Videos often include type, videoId, title, description, channelTitle, channelId, channelHandle, channelThumbnail / channelAvatar, view counts, publish hints, lengthText, thumbnail, richThumbnail, badges, and related fields.
• Channels, playlists, and other kinds use overlapping but not identical fields; each row reflects what the search returns for that item type.
• Search context: searchQuery, optional region, resultType, and scrapedAt on every row.

Field names and availability depend on result type and may change over time.

Sample output (one video row, illustrative)

{
	"type": "video",
	"videoId": "BHcyuzXRqLs",
	"title": "50 Cooking Tips With Gordon Ramsay | Part One",
	"channelTitle": "Gordon Ramsay",
	"channelId": "UCIEv3lZ_tNXHzL3ox-_uUGQ",
	"channelHandle": "@gordonramsay",
	"channelThumbnail": [
		{
			"url": "https://yt3.ggpht.com/iu8M-gugkNvz-lHxC1sMEfAlL7ONWbP91c5SM9bb98oCJAcYUl0HIAMZFFR2Dd-soGag1Y1y8A=s68-c-k-c0x00ffffff-no-rj",
			"width": 68,
			"height": 68
		}
	],
	"channelAvatar": [
		{
			"url": "https://yt3.ggpht.com/iu8M-gugkNvz-lHxC1sMEfAlL7ONWbP91c5SM9bb98oCJAcYUl0HIAMZFFR2Dd-soGag1Y1y8A=s68-c-k-c0x00ffffff-no-rj",
			"width": 68,
			"height": 68
		}
	],
	"channelBadges": [
		"Verified"
	],
	"isVerifiedChannel": true,
	"description": "Here are 50 cooking tips to help you become a better chef! #GordonRamsay #Cooking Gordon Ramsay's Ultimate Fit ...",
	"viewCountText": "14,805,797 views",
	"viewCount": "14805797",
	"publishedTimeText": "4 years ago",
	"publishDate": "2022-03-26",
	"publishedAt": "2022-03-26T00:00:00Z",
	"lengthText": "20:19",
	"thumbnail": [
		{
			"url": "https://i.ytimg.com/vi/BHcyuzXRqLs/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLB0JPR1jDAY5-z7ab5rkf6X8EMGvQ",
			"width": 360,
			"height": 202
		},
		{
			"url": "https://i.ytimg.com/vi/BHcyuzXRqLs/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAmWd4CKd6GJtLKDGU59D0ObshkOA",
			"width": 720,
			"height": 404
		}
	],
	"richThumbnail": [
		{
			"url": "https://i.ytimg.com/an_webp/BHcyuzXRqLs/mqdefault_6s.webp?du=3000&sqp=COiVl84G&rs=AOn4CLCZXEhWeIluNfeVxH2jDB6SjS1xrg",
			"width": 320,
			"height": 180
		}
	],
	"searchQuery": "cooking tips",
	"region": "US",
	"resultType": "video",
	"scrapedAt": "2026-03-27T01:07:59.019Z"
}