{"uid":"cap_PyY4pNJ0125kOYUbEcZWV","slug":"api-direct-youtube-video-search-11def455","name":"API Direct YouTube Video Search","description":"Search for YouTube videos by keyword.","url":"https://x402.apidirect.io/v1/youtube/posts?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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["query"],"properties":{"pages":{"type":"integer","default":1,"maximum":20,"minimum":1,"description":"Number of pages to fetch and merge (1-20). Billed per page."},"query":{"type":"string","maxLength":500,"description":"Search query (max 500 characters)"},"upload_date":{"enum":["last_hour","today","this_week","this_month","this_year"],"type":"string","description":"Filter by upload date"},"get_sentiment":{"type":"boolean","default":false,"description":"Set to true to add AI emotion analysis to each post. Adds a `sentiment` object containing `emotions` (joy, trust, fear, surprise, sadness, disgust, anger and anticipation, each scored 0-100), `dominant_emotion`, `emotional_intensity` (0-10), and `polarity` (positive, negative or neutral). Any post t"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.006","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.006/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_PCz3Yb2fDllDissoueTtc","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search YouTube for videos matching a keyword query, with optional date filtering and AI sentiment analysis.","exampleAgentPrompt":"Search YouTube for 'electric vehicle reviews' uploaded this week and return 2 pages of results with AI sentiment analysis enabled.","exampleUseCases":[{"title":"Brand monitoring on YouTube","prompt":"Search YouTube for videos mentioning 'Nike Air Max' uploaded this month — I want 3 pages of results with sentiment analysis so I can see how people are reacting emotionally."},{"title":"Trending news video discovery","prompt":"Find me YouTube videos about the latest earthquake uploaded in the last hour — just 1 page, no sentiment needed, I just want to see what's being posted right now."},{"title":"Competitor content research","prompt":"Search YouTube for 'Shopify tutorial' videos from this year, give me 5 pages of results, and turn on sentiment analysis so I can understand the emotional tone of the content."}],"resultDescription":"A paginated list of YouTube video results matching the search query, including video metadata (titles, URLs, channel info, etc.), optionally enriched with AI sentiment objects per video containing emotion scores (joy, trust, fear, surprise, sadness, disgust, anger, anticipation each 0-100), dominant emotion, emotional intensity (0-10), and polarity (positive/negative/neutral).","failureModes":["Empty results if query matches no YouTube videos","Rate limiting or billing errors if too many pages requested simultaneously","Invalid query length error if query exceeds 500 characters","Payment failure if USDC balance is insufficient (billed per page)","Invalid upload_date enum value returns validation error","Sentiment analysis unavailable or incomplete for very short video metadata"],"whenToPreferThis":"Use this endpoint when you need to search YouTube video content by keyword with optional temporal filtering and AI emotional tone analysis. Prefer it over general web search when you specifically want YouTube results. Choose it over manual YouTube browsing when you need structured, machine-readable video data at scale. The sentiment analysis feature makes it especially useful for brand monitoring, audience research, or content strategy work where emotional tone matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:08:14.943Z","isFirstParty":false,"canonicalSlug":"api-direct-youtube-video-search-11def455"}