{"uid":"cap_WmVEXi8nZ8poLgwQ9xhDV","slug":"openverbs-youtube-search-942c7602","name":"OpenVerbs YouTube Search","description":"Live YouTube video-search results for a query, localised by location and language. Returns ranked videos with title, URL, video id, channel, view count, publish date and duration.","url":"https://search.openverbs.com/v1/youtube","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["q"],"properties":{"q":{"type":"string","maxLength":700,"minLength":1,"description":"Search query."},"limit":{"type":"integer","maximum":100,"minimum":1,"description":"Depth / maximum results. Defaults to 10."},"language":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"Language code (2-letter). Defaults to en."},"location":{"type":"string","maxLength":120,"minLength":2,"description":"Location name, e.g. \"United States\" or \"London,England,United Kingdom\". Defaults to United States."}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"total":500000,"results":[{"url":"https://www.youtube.com/watch?v=jxLkbJozKbY","rank":1,"title":"How Ethereum Works — A Clear Explanation","views":1250000,"isLive":false,"channel":"Finematics","videoId":"jxLkbJozKbY","isShorts":false,"published":"2025-11-02","channelUrl":"https://www.youtube.com/@Finematics","durationSeconds":725}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_NqVX0A_riRoXfwoU-dsMn","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns live, localised YouTube video search results including title, URL, video ID, channel, view count, publish date, and duration for a given query.","exampleAgentPrompt":"Search YouTube for 'sourdough bread tutorial' and give me the top 5 results in English from the United States — I want each video's title, channel, view count, and link.","exampleUseCases":[{"title":"Research trending videos by region","prompt":"Search YouTube for 'climate change protests' and return the top 10 results localised to the United Kingdom in English, with view counts and publish dates so I can see what's trending there."},{"title":"Find tutorial videos for a product","prompt":"Look up YouTube videos for 'how to set up a Raspberry Pi' — give me up to 20 results in English from the United States, including the video URL, channel name, and duration for each."},{"title":"Discover local-language video content","prompt":"Search YouTube for 'recetas de cocina mexicana' in Spanish localised to Mexico and return the top 15 videos with titles, view counts, and links."}],"resultDescription":"A ranked list of YouTube videos matching the query, each containing the video title, YouTube URL, video ID, channel name, view count, publish date, and duration. Results are filtered and ranked according to the specified location and language context.","failureModes":["Empty results if query is too obscure or misspelled","Rate limiting or payment failure (x402) if USDC payment is not processed","Invalid language code (non-2-letter) returns a validation error","Location string not recognised may fall back to default (United States)","Limit exceeding 100 returns a validation error","Network timeout if YouTube is slow to respond"],"whenToPreferThis":"Choose this endpoint when you need live, structured YouTube search results with metadata (view count, publish date, duration, channel) and require localisation by country and language. Prefer it over scraping YouTube directly or using outdated cached data. Ideal for agents that need to surface relevant videos programmatically for a specific region or language audience.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:39:58.665Z","isFirstParty":false}