{"uid":"cap_nfbouiGQoHnsyPNGw8r3T","slug":"hirescrape-youtube-scraper-api-ce144f1b","name":"Hirescrape YouTube Scraper API","description":"Pay-per-call web scrapers for AI agents. 28 tools across Reddit, 8-board job search (LinkedIn · Indeed · Glassdoor · Google Jobs · +5), TikTok · Douyin · Bilibili, cross-platform trend research, social media, and ad libraries. No API keys. Agent wallets settle USDC on Tempo or Base via x402 + MPP.","url":"https://www.hirescrape.com/api/tools/youtube","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"url":{"type":"string","description":"Full URL of the target object."},"mode":{"enum":["video","videos_by_explore","videos_by_hashtag","videos_by_keyword","videos_by_podcast_url","videos_by_search_filters","videos_by_url","channel","channels_by_keyword","comments"],"type":"string","default":"video","description":"Which endpoint to call. Options: video, videos_by_explore, videos_by_hashtag, videos_by_keyword, videos_by_podcast_url, videos_by_search_filters, videos_by_url, channel, channels_by_keyword, comments."},"type":{"type":"string","description":"Content type (all or shorts)."},"limit":{"type":"integer","default":20,"maximum":500,"minimum":1,"description":"Max items to collect (applies to paginated modes)."},"country":{"type":"string","description":"Country code (e.g. US, GB)."},"hashtag":{"type":"string","description":"Hashtag (without #)."},"keyword":{"type":"string","description":"Search keyword."},"sort_by":{"type":"string","description":"Sort key (depends on endpoint)."},"all_tabs":{"type":"boolean","description":"Scrape all tabs on the destination page."},"duration":{"type":"string","description":"Duration filter (Under 4 minutes / 4-20 minutes / Over 20 minutes)."},"end_date":{"type":"string","description":"End date (YYYY-MM-DD)."},"features":{"type":"string","description":"Feature filter (4K / HD / Creative Commons / Subtitles)."},"order_by":{"type":"string","description":"Sort order for discovered videos (Latest / Oldest / Popular)."},"start_date":{"type":"string","description":"Start date (YYYY-MM-DD)."},"time_period":{"type":"string","description":"Lookback window (e.g. '1 day ago', '1 month ago', '1 year ago')."},"upload_date":{"type":"string","description":"Upload recency filter (Today / Week / Month / Year)."},"num_of_posts":{"type":"integer","description":"Max records to collect (0 = provider default)."},"keyword_search":{"type":"string","description":"Keyword for filtered video search."},"transcription_language":{"type":"string","description":"BCP-47 language code for transcript (e.g. en, es). Empty = auto."}}},"responseSchema":{"type":"json","schema":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"type":"object"},"description":"Scraped items. Shape varies per tool — see each tool's outputSample for a concrete example."},"runId":{"type":"string","description":"Run ID for debugging/audit."},"payment":{"type":"object","description":"Settlement summary (protocol, amount, currency)."},"duration":{"type":"integer","description":"Run duration in seconds."}}},"example":{"items":[{"note":"Shape varies per tool — see each tool's docs for fields."}],"runId":"sc_example","payment":{"amount":"0.040000","currency":"USD","protocol":"x402"},"duration":4}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.00225","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.00225/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.00225","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.00225","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2TAjB-u-LXW8GlV8aENnR","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.00225","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scrapes YouTube videos, channels, comments, hashtags, keywords, and trending content via a pay-per-call API with no API key required","exampleAgentPrompt":"Pull the top 50 YouTube videos matching the keyword 'AI agents' uploaded in the last month, sorted by popularity — I need the titles, view counts, and channel names.","exampleUseCases":null,"resultDescription":"Returns a JSON object with an 'items' array of scraped YouTube entities (videos, channels, comments, etc.) whose shape depends on the mode used, plus a runId for debugging, a payment settlement summary, and the run duration in seconds.","failureModes":["Invalid or inaccessible YouTube URL returns empty items array","Unsupported mode value causes validation error","limit exceeds maximum of 500 and is rejected","Insufficient USDC wallet balance causes payment failure via x402","Rate limiting or YouTube blocking causes partial or empty results","Invalid country code or date format causes parameter error"],"whenToPreferThis":"Use this endpoint when you need to scrape YouTube data (videos, channels, comments, hashtags, keyword searches, trending content) without a YouTube Data API key, especially in AI agent workflows that support x402 micropayment settlement. Prefer this over the official YouTube API when you need flexible scraping modes like podcast URL discovery, search filter combinations, or cross-tab channel data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:36:08.749Z","isFirstParty":false}