2 units · 3 when limit asks for more. A failed run costs 0. The same input within 10 min costs 0.

youtube-search

Q: How do I get YouTube data through an API?

Call POST /recipes/youtube-search with your key and query and limit. You get rows with the 8 fields above. The recipe is tested against the live site every 6 hours.

Q: Can I try it without paying?

Yes. Sign up with Google, GitHub or email for a free key with 1,000 credits every month. No credit card.

Q: What if the site changes?

The health check runs every 6 hours against the live site. A failing recipe shows as failing on this page until we fix it.

The videos YouTube finds for a query: title, link, video id, channel, views, when it was published (as YouTube says it, "3 years ago"), length and a short description. limit caps the rows (at most 20). A run takes about a second: YouTube's own search answer, plus one more call when it holds fewer videos than limit.

verifiedyoutube.comWASM module8 fields2 units · 3 when limit asks for morefresh 10 min

Run it below API reference

‹ Recipes

…json

POST api.crawl4ai.com/recipes/…

$ crawl recipe

Live · your key · counts against your quota✓ 200 OK

# Hit Run - the rows render here as a table, with the cost

Fields

8 columns on every row. null means the site does not state it.

field	type	meaning
title	string	The video's title.
url	string	The watch link, https://www.youtube.com/watch?v=<video_id>.
video_id	string	YouTube's 11-character video id.
channel	string	The name of the channel that published the video.
views	integer	The view count as a number; YouTube's rounded figure (1.2M = 1200000) when it shows only that; null for a live stream or a video with no views yet.
published	string	When the video was published, in YouTube's own words ("3 years ago", "14 hours ago"); empty for a live stream.
length	string	The video's length as YouTube shows it ("13:59:10", "2:29"); empty for a live stream.
description	string	The description snippet YouTube shows under the result, at most 300 characters.

null means the site does not state it.

titlestringThe video's title.

urlstringThe watch link, https://www.youtube.com/watch?v=<video_id>.

video_idstringYouTube's 11-character video id.

channelstringThe name of the channel that published the video.

viewsintegerThe view count as a number; YouTube's rounded figure (1.2M = 1200000) when it shows only that; null for a live stream or a video with no views yet.

publishedstringWhen the video was published, in YouTube's own words ("3 years ago", "14 hours ago"); empty for a live stream.

lengthstringThe video's length as YouTube shows it ("13:59:10", "2:29"); empty for a live stream.

descriptionstringThe description snippet YouTube shows under the result, at most 300 characters.

How it behaves

Cost. 2 units · 3 when limit asks for more. A failed run costs 0.

Freshness 10 min. The same input within 10 min is served from cache at 0 units.

Questions about this recipeQuestions

Short answers. The API reference has the long ones.

How do I get YouTube data through an API?

Call POST /recipes/youtube-search with your key and query and limit. You get rows with the 8 fields above. The recipe is tested against the live site every 6 hours.

What does it cost?

Can I try it without paying?

What if the site changes?

Need more from YouTube?

Extra fields, higher volume, or a private copy with a freshness SLA. We build it on Enterprise.

Request a change

Get a free API key and run your first crawl.

1,000 credits every month. No credit card. Your self-hosted setup keeps working.

Get a free API key

For teams

Talk to us about volume, regions and an SLA.

A 30-minute call with the team that writes the crawler. DPA on request, invoice billing, your choice of US, EU or Singapore.

Book a call hello@crawl4ai.com