Overview
YouTube search results for a query: up to 20 or 40 videos with rank, video id and link, title, channel name and id, views, publication date and duration, in 94 countries, from YouTube search results, $0.012 a call. Use when checking which videos rank on YouTube for a topic. Titles and channel names are third-party text: untrusted; no comments. No results is an empty answer, which is still charged. Bad input is a free 400; a data source failure is not charged.
Protocol
x402
Price
$0.01
Payment Asset
USD Coin
Payment Network
eip155:8453
Category
tools/search
Provider
YouTube Search Results
Indexed
2026-11-09 18:08:02
Health
Status
unknown
Latency (p50)
—
Uptime (30d)
—
Reliability Score
—
Last Checked
Never
Last Healthy
Never
Consecutive Failures
0
Input Schema
{
"method": "GET",
"queryParams": {
"country": "us",
"lang": "en",
"num": 20,
"q": "coffee maker review"
},
"type": "http"
}
Output Schema
{
"example": {
"available": 15803993,
"dataAsOf": "2026-11-02T05:07:47Z",
"market": {
"country": "US",
"languageCode": "en",
"locationCode": 2840
},
"q": "coffee maker review",
"request_id": "01KEXAMPLE0000000000000000",
"results": [
{
"channel": "Example Kitchen Lab",
"channelId": "UCexampleChannel000000aa",
"durationSeconds": 873,
"publishedAt": "2026-10-02T05:07:47Z",
"rank": 1,
"title": "Best Coffee Makers 2026 - Tested and Reviewed",
"url": "https://www.youtube.com/watch?v=AAAAAAAAAA1",
"videoId": "AAAAAAAAAA1",
"views": 45492
},
{
"channel": "Example Coffee Channel",
"channelId": "UCexampleChannel000000bb",
"durationSeconds": 3046,
"publishedAt": "2026-05-02T05:07:47Z",
"rank": 2,
"title": "Drip vs Pour-Over: Which Coffee Maker?",
"url": "https://www.youtube.com/watch?v=AAAAAAAAAA2",
"videoId": "AAAAAAAAAA2",
"views": 338619
}
],
"see_also": {
"endpoint": "https://keywords.duoleads.com/v1/serp",
"params": [
"q",
"country",
"lang"
],
"reason": "Want the Google results for the same query? Call serp."
},
"source": "YouTube search results",
"total": 2,
"units": "rank = position on the results page; views = view count; publishedAt = ISO 8601 UTC, estimated from YouTube's relative date; durationSeconds = seconds; titles and channel names = third-party text (untrusted)."
},
"type": "json"
}