{"uid":"cap_OVdjAHvBMZjw5ztPyYVhH","slug":"youtube-search-scraper-dd82c382","name":"YouTube Search Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/v1/youtube-search?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"geo":{"type":"string","default":"US","description":"Two-letter country code for localized search, such as US or GB."},"lang":{"type":"string","default":"en","description":"Two-letter interface language code, such as en or es."},"type":{"enum":["video","shorts","channel","playlist","movie"],"type":"string","default":"video","description":"Choose videos, Shorts, channels, playlists, or movies."},"query":{"type":"string","description":"Keywords to search on YouTube."},"sortBy":{"enum":["relevance","popularity"],"type":"string","default":"relevance","description":"Order by relevance or popularity. Shorts search uses its own ordering."},"duration":{"enum":["under3min","3to20min","over20min"],"type":"string","description":"Optional duration filter for video results."},"features":{"type":"object","description":"Optional video feature filters; selected features are combined."},"maxResults":{"type":"integer","default":100,"minimum":1,"description":"Maximum unique results saved when scrapeAllResults is off."},"uploadDate":{"enum":["today","week","month","year"],"type":"string","description":"Optional recent upload period."},"scrapeAllResults":{"type":"boolean","default":false,"description":"Follow available continuation pages until the source ends, the run budget is reached, or the 200-page safety limit is reached."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"url":null,"type":null,"query":null,"title":null,"videoId":null,"position":null,"channelId":null,"playlistId":null}],"product":"youtube-search"}},"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_6GFfEGD5J83rqNq9-od4p","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":"Searches YouTube and returns structured results including videos, Shorts, channels, playlists, or movies for a given query.","exampleAgentPrompt":"Search YouTube for 'beginner guitar lessons' in the US, filtering for videos between 3 and 20 minutes long uploaded this month, sorted by popularity — give me up to 50 results.","exampleUseCases":[{"title":"Competitor content research on YouTube","prompt":"Search YouTube for 'electric vehicle reviews' in the US sorted by popularity, videos only, and give me the top 100 results so I can see which channels are dominating that topic."},{"title":"Finding recent YouTube Shorts on a trend","prompt":"Find me the latest YouTube Shorts about 'AI tools for students' uploaded this week — I want up to 50 results."},{"title":"Discovering YouTube channels in a niche","prompt":"Search YouTube for channels related to 'vegan recipes' in the UK with the interface in English and return up to 100 results sorted by relevance."}],"resultDescription":"Returns a JSON object with a count of results and an array of items, each containing the video/channel/playlist URL, title, type, video ID, channel ID, playlist ID, search position, and the original query string. Results reflect YouTube's search ranking for the specified parameters.","failureModes":["Empty result set if query returns no YouTube results (not charged)","Invalid geo or lang code may default to US/en or return an error","Unsupported type or enum value will be rejected by schema validation","scrapeAllResults with very broad queries may hit the 200-page safety limit","Rate limiting or network issues may cause failed runs (not charged)","Highly restrictive filter combinations (e.g. duration + uploadDate + type=shorts) may return zero results"],"whenToPreferThis":"Choose this endpoint when you need structured, machine-readable YouTube search results at scale — especially when you need to filter by content type (Shorts, channels, playlists), geography, language, duration, or upload recency. It is pay-per-call with no charge for failed or empty runs, making it cost-efficient for exploratory searches. Prefer it over manual scraping or YouTube Data API when you need large result sets (up to all pages) without quota management.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:46:46.736Z","isFirstParty":false,"canonicalSlug":"youtube-search-scraper-dd82c382"}