{"uid":"cap_fqkCLdayFHoigZiux3jZ5","slug":"swarmio-video-search-6160249f","name":"Swarmio Video Search","description":"Swarmio does real work for you — research, plans, and readings that better your life, live.","url":"https://ioswarm.io/api/v1/video/search?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"sort":{"enum":["relevance","rating","date","views"],"type":"string"},"limit":{"type":"integer","description":"results, 1-50 (default 10)"},"query":{"type":"string","description":"what to search for"},"within":{"enum":["hour","today","week","month","year"],"type":"string","description":"recency filter (server-side; the only way to get genuinely recent results)"},"duration":{"enum":["short","medium","long"],"type":"string"}}},"responseSchema":{"type":"json","example":{"paid":{"usd":0.02,"transaction":"0x…"},"count":10,"known":true,"query":"rust async runtime","quota":{"free_per_day":25,"free_remaining_today":22},"results":[{"id":"…","url":"https://www.youtube.com/watch?v=…","title":"…","channel":"…","view_count":120000,"live_status":null,"duration_sec":1834}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_bSo9hZvEJsEo14WapR834","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches YouTube for videos by keyword with optional recency, duration, and sort filters, returning ranked results with metadata.","exampleAgentPrompt":"Search for the top 5 YouTube videos about 'rust async runtime' from the past week, sorted by rating, and show me the titles, channels, and view counts.","exampleUseCases":[{"title":"Breaking news video discovery","prompt":"Find me the 10 most recent YouTube videos about the Federal Reserve interest rate decision from today, sorted by date — I want to see what's been published in the last hour."},{"title":"Learning tutorial search","prompt":"Search YouTube for medium-length tutorial videos about building REST APIs in Go, sorted by rating, and give me the top 8 results."},{"title":"Trending topic video research","prompt":"Pull the 15 most-viewed YouTube videos about AI agents from the past month — I want to see which channels are covering the topic and how many views they're getting."}],"resultDescription":"Returns a JSON object with the total count of results, the search query echoed back, quota usage (free calls remaining today), payment confirmation, and an array of up to 50 video objects each containing: video ID, full YouTube URL, title, channel name, view count, live status, and duration in seconds.","failureModes":["Invalid sort enum value returns a validation error","Invalid within enum value returns a validation error","Invalid duration enum value returns a validation error","limit out of range (< 1 or > 50) returns a validation error","Empty or missing query returns an error","Payment failure (insufficient USDC) blocks the request","Daily free quota exhausted may require payment","YouTube backend unavailability returns a service error"],"whenToPreferThis":"Use this endpoint when you need structured, filterable YouTube video search results with metadata like view counts and duration — especially when recency is important (the `within` parameter is the only way to guarantee genuinely fresh results). Prefer this over general web search when you specifically need video content with channel attribution and engagement metrics. It is well-suited for agents that need to surface trending video content, conduct research on multimedia coverage of a topic, or build video recommendation workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T12:30:05.449Z","isFirstParty":false,"canonicalSlug":"swarmio-video-search-6160249f"}