{"uid":"cap_7jX81NblStN2HJV0Oh6Go","slug":"youtube-channel-scraper-5e09b8e4","name":"YouTube Channel Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/v1/youtube-channel?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"maxItems":{"type":"integer","default":0,"minimum":0,"description":"Stop after this many items across all channels. Set to 0 for no global cap."},"startUrls":{"type":"array","description":"Public channel URLs such as https://www.youtube.com/@NASA. Handles, channel IDs, legacy custom and user URLs are accepted."},"maxResults":{"type":"integer","default":10,"minimum":0,"description":"Maximum regular videos to collect from each channel. Set to 0 to skip videos."},"sortVideosBy":{"enum":["NEWEST","POPULAR","OLDEST"],"type":"string","default":"NEWEST","description":"Sort each requested channel tab by newest, popular, or oldest."},"oldestPostDate":{"type":"string","default":"","description":"Optional earliest date for videos and streams as YYYY-MM-DD or a relative age such as 30 days. Shorts lack a list-page date and are not filtered."},"maxResultStreams":{"type":"integer","default":0,"minimum":0,"description":"Maximum streams to collect from each channel. Set to 0 to skip streams."},"maxResultsShorts":{"type":"integer","default":0,"minimum":0,"description":"Maximum Shorts to collect from each channel. Set to 0 to skip Shorts."},"includeVideoDetails":{"type":"boolean","default":false,"description":"Read each video page for description links, an exact publication date, and a more precise view count. This makes runs slower."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"id":null,"url":null,"date":null,"title":null,"duration":null,"viewCount":null,"publishedAt":null,"viewCountText":null}],"product":"youtube-channel"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","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.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_CULqXeMEhaPmuhOqxFfD6","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scrapes public YouTube channel metadata and video listings (videos, streams, Shorts) from one or more channel URLs, returning structured JSON.","exampleAgentPrompt":"Pull the 20 most recent videos from the NASA YouTube channel at https://www.youtube.com/@NASA, sorted by newest, and include their titles, view counts, and publish dates — skip Shorts and streams.","exampleUseCases":[{"title":"Track competitor channel uploads","prompt":"Grab the 15 newest videos from https://www.youtube.com/@MrBeast, sorted by newest, with their titles, view counts, and URLs — no Shorts or streams needed."},{"title":"Audit channel's most popular content","prompt":"Get the top 25 most popular videos from https://www.youtube.com/@veritasium — sort by popularity and include full video details like descriptions and exact publish dates."},{"title":"Monitor channel for recent streams","prompt":"Fetch up to 10 streams posted in the last 30 days from https://www.youtube.com/@NASA, sorted by newest, and return their titles, URLs, and view counts."}],"resultDescription":"A JSON object with a count field and an items array, where each item contains the video ID, URL, title, date, duration, view count (raw and formatted text), and published timestamp. The product field identifies the data type as 'youtube-channel'.","failureModes":["Invalid or private channel URL returns empty items array (not charged)","Channel with no videos in the requested category returns count 0","Rate limiting or YouTube blocking may cause empty runs (not charged)","Invalid date format in oldestPostDate causes validation error","Unsupported channel URL format may fail to resolve"],"whenToPreferThis":"Use this endpoint when you need structured video listings from one or more YouTube channels without managing your own scraping infrastructure. It handles legacy URLs, handles, and channel IDs, supports filtering by date and content type, and offers optional deep video detail fetching. Prefer it over generic web scrapers when you specifically need YouTube channel video metadata in a pay-per-successful-call model.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:59.223Z","isFirstParty":false,"canonicalSlug":"youtube-channel-scraper-5e09b8e4"}