{"uid":"cap_qwVMHZxUERmN7yP7DsL-Q","slug":"youtube-search-scraper-x402-aac4404a","name":"YouTube Search Scraper (x402)","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://x402.186-241-26-229.sslip.io/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_BGmSlugPAkzLBcBJqWEMF","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 video, channel, playlist, short, and movie metadata for a given query.","exampleAgentPrompt":"Search YouTube for 'machine learning tutorials' in the US, return up to 50 videos sorted by popularity, and only include videos over 20 minutes long uploaded this month.","exampleUseCases":[{"title":"Research trending competitor content","prompt":"Search YouTube for 'electric vehicles 2025' in the US, sort by popularity, and give me the top 30 videos so I can see what content is performing best in that space right now."},{"title":"Find recent Shorts for a campaign","prompt":"Find YouTube Shorts about 'home workout' uploaded in the last week, up to 100 results, for the US market — I need video IDs and titles to analyze for a social media campaign."},{"title":"Discover top channels in a niche","prompt":"Search YouTube for channels about 'personal finance' in English, sorted by relevance, and give me up to 50 channel results with their channel IDs."}],"resultDescription":"Returns a JSON object with a count of results and an array of items, each containing the video/channel/playlist URL, content type, search query, title, videoId, channelId, playlistId, and position in the results list.","failureModes":["Empty result set if query matches nothing on YouTube — not charged","Network or scraping failure returns an error — not charged","Invalid enum value for type, sortBy, duration, or uploadDate returns a validation error","Missing required 'query' field results in a bad request error","maxResults set below minimum of 1 is rejected","Rate limits or YouTube anti-scraping measures may cause transient failures"],"whenToPreferThis":"Choose this endpoint when you need structured, machine-readable YouTube search results without building your own scraper — especially when you need localized results by country/language, content-type filtering (videos, Shorts, channels, playlists, movies), or duration/recency filters. It's pay-per-call with no charge for failed or empty runs, making it cost-efficient for exploratory searches. Prefer this over the YouTube Data API when you want to avoid API quota limits or need results that closely mirror what a user would see on YouTube.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:46:10.919Z","isFirstParty":false,"canonicalSlug":"youtube-search-scraper-x402-aac4404a"}