{"uid":"cap_XaI3blOsxjbLOTyDjyxCA","slug":"scrapemole-youtube-search-api-df6ad79e","name":"ScrapeMole YouTube Search API","description":"Pay-per-call public web data for agents: Google Trends, YouTube transcripts, YouTube search, YouTube channel videos, YouTube video details, YouTube comments, YouTube playlists. Pay per successful call in USDC with x402; errors are never charged. No accounts, no API keys.\n\nPayments: x402 v2, scheme \"exact\", USDC on Base (eip155:8453). The payment is verified before the scrape and settled only when the response is 200. Terms: https://scrapemole-api-mainnet.scrapemole.workers.dev/terms","url":"https://scrapemole-api-mainnet.scrapemole.workers.dev/v1/youtube/search?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["q"],"properties":{"q":{"type":"string","examples":["espresso machine review"],"description":"Search query."},"lang":{"type":"string","examples":["en"],"description":"Interface language (hl), e.g. en, de."},"sort":{"enum":["relevance","date","views","rating"],"type":"string","default":"relevance","description":"Sort order."},"limit":{"type":"string","default":"20","description":"Max videos (1-50)."},"country":{"type":"string","examples":["US"],"description":"Country (gl), e.g. US, GB."},"duration":{"enum":["any","short","medium","long"],"type":"string","default":"any","description":"Duration filter."},"uploaded":{"enum":["any","hour","today","week","month","year"],"type":"string","default":"any","description":"Upload date filter."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"count":2,"videos":[{"url":"https://www.youtube.com/watch?v=4MJnPVnY3_o","title":"The Best Espresso Machine You've Never Heard Of","badges":["4K"],"isLive":false,"isShort":false,"videoId":"4MJnPVnY3_o","category":"People & Blogs","keywords":[],"position":2,"channelId":"UCu7x43fFlwbBykF1r04T_wQ","isLiveNow":false,"likeCount":1986,"viewCount":158741,"channelUrl":"https://www.youtube.com/channel/UCu7x43fFlwbBykF1r04T_wQ","sourceType":"search","uploadDate":"2026-02-07T03:00:13-08:00","channelName":"Daddy Got Coffee","description":"The $3,000 espresso category hasn’t changed in years — until now.\nThe Arkel Coast brings saturated group performance, flow control, shot programming, and pro-level build into a price bracket where those specs normally don’t exist.\n\n10% off Arkel Coast at Cafune  - https://geni.us/ArkelCoast (Use - D…","publishDate":"2026-02-07T03:00:13-08:00","searchQuery":"espresso machine review","commentCount":280,"durationText":"20:15","isFamilySafe":true,"thumbnailUrl":"https://i.ytimg.com/vi/4MJnPVnY3_o/maxresdefault.jpg","channelHandle":"@DaddyGotCoffee","publishedText":"8 months ago","viewCountText":"158,741 views","durationSeconds":1215,"isShortsEligible":false,"isVerifiedChannel":false,"publishedAtApprox":"2026-02-07","descriptionSnippet":"The $3000 espresso category hasn't changed in years — until now. The Arkel Coast brings saturated group performance, flow ...","availableCountriesCount":249},{"url":"https://www.youtube.com/watch?v=miNqgmVH9I0","title":"Best Entry Level Espresso Machines 2025 – Our Top Picks for Beginners","badges":["4K"],"isLive":false,"isShort":false,"videoId":"miNqgmVH9I0","category":"Howto & Style","keywords":["best entry level espresso machine 2025","espresso machine for beginners"],"position":3,"channelId":"UCJwRmBtnYh_7Xs9oXUrLhZg","isLiveNow":false,"likeCount":1259,"viewCount":169694,"channelUrl":"https://www.youtube.com/channel/UCJwRmBtnYh_7Xs9oXUrLhZg","sourceType":"search","uploadDate":"2025-11-07T12:30:07-08:00","channelName":"Whole Latte Love","description":"Looking for the best entry level espresso machine in 2025? We tested the top affordable espresso machines to find which ones make real café-quality shots at home. In this video, John from Whole Latte Love shares our top picks, hands-on insights, and what to look for in your first espresso machine.\n\n…","publishDate":"2025-11-07T12:30:07-08:00","searchQuery":"espresso machine review","commentCount":115,"durationText":"15:30","isFamilySafe":true,"thumbnailUrl":"https://i.ytimg.com/vi_webp/miNqgmVH9I0/maxresdefault.webp","channelHandle":"@Wholelattelovepage","publishedText":"11 months ago","viewCountText":"169,716 views","durationSeconds":929,"isShortsEligible":false,"isVerifiedChannel":true,"publishedAtApprox":"2025-11-08","descriptionSnippet":"Looking for the best entry level espresso machine in 2025? We tested the top affordable espresso machines to find which ones ...","availableCountriesCount":249}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_yYQYt1mfRvDipmmGCHxPr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search YouTube videos by keyword and return ranked results with metadata including view counts, durations, channel info, and descriptions","exampleAgentPrompt":"Search YouTube for 'espresso machine review' and show me the top 10 most viewed results uploaded in the last year, sorted by view count.","exampleUseCases":[{"title":"Competitor video research for marketers","prompt":"Search YouTube for 'cold brew coffee maker review' and give me the top 20 results sorted by view count so I can see which channels are dominating that topic."},{"title":"Finding recent tutorial videos","prompt":"Find YouTube videos about 'Python async programming' uploaded in the last month, sorted by relevance, and list the top 15 with their titles, view counts, and channel names."},{"title":"Trend monitoring for content creators","prompt":"Search YouTube for 'AI agent tools' and show me the most recent 20 videos so I can see what content is being published right now in that space."}],"resultDescription":"Returns a JSON object with a count field and a videos array. Each video object includes: videoId, url, title, channelName, channelId, channelUrl, channelHandle, viewCount, likeCount, commentCount, durationSeconds, durationText, uploadDate, publishDate, publishedText, thumbnailUrl, description, descriptionSnippet, category, keywords, badges, position, isLive, isShort, isFamilySafe, isVerifiedChannel, searchQuery, and availableCountriesCount. Results can contain up to 50 videos per call.","failureModes":["Empty results if the search query returns no YouTube videos","Payment failure if USDC balance is insufficient or x402 header is malformed — no charge applied","Invalid query parameter (q is required; omitting it returns a 400 error)","Invalid enum values for sort, duration, or uploaded fields return validation errors","Limit out of range (must be 1-50) causes a 400 error","YouTube rate limiting or scraping blocks may cause intermittent 500 errors — not charged"],"whenToPreferThis":"Use this endpoint when you need YouTube search results without a Google API key or quota limits, want pay-per-call pricing with no account setup, need rich metadata per video (likes, comments, duration, channel info), or want to filter by upload date, duration, or country. Prefer this over the YouTube Data API when you want to avoid quota management or account provisioning, and over generic web scrapers when you want structured, consistently formatted JSON output.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:36:04.736Z","isFirstParty":false,"canonicalSlug":"scrapemole-youtube-search-api-df6ad79e"}