{"uid":"cap_HtM7QlVlVjVyZL5AP4o19","slug":"socialfetch-youtube-search-3f7600ef","name":"SocialFetch YouTube Search","description":"Search YouTube videos, channels, and playlists by keyword.","url":"https://api.socialfetch.dev/v1/youtube/search","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"],"type":"string"},"queryParams":{"type":"object","required":["query"],"properties":{"type":{"enum":["videos","shorts","channels","playlists"],"type":"string","description":"Optional content type filter for search results."},"query":{"type":"string","maxLength":512,"minLength":1,"description":"Search query text for YouTube content."},"cursor":{"type":"string","minLength":1,"description":"Opaque pagination cursor returned by a previous response."},"region":{"type":"string","description":"Optional ISO 3166-1 country code for localized search results."},"sortBy":{"enum":["relevance","popular"],"type":"string","description":"Optional sort order for search results."},"duration":{"enum":["under_3_min","between_3_and_20_min","over_20_min"],"type":"string","description":"Optional duration filter for video results. Applies to videos, not shorts."},"uploadDate":{"enum":["today","this_week","this_month","this_year"],"type":"string","description":"Optional upload date filter for video results."},"includeExtras":{"type":"boolean","description":"When true, returns richer per-video metadata when available. May increase response time."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.014","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.014/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.014","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.014","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9xoVsrgJsVNIQABxclmw2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.014","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search YouTube videos, channels, and playlists by keyword with optional filters for type, region, sort order, duration, and upload date.","exampleAgentPrompt":"Search YouTube for 'sourdough bread tutorial' and filter to videos uploaded this month, sorted by popularity, longer than 20 minutes — show me the top results.","exampleUseCases":null,"resultDescription":"A list of YouTube search results matching the query, which may include videos, channels, or playlists depending on the type filter. Each result includes metadata such as title, channel name, view counts, and URLs. When includeExtras is true, richer per-item metadata is returned. A pagination cursor is included when more results are available.","failureModes":["Missing required 'query' parameter returns a validation error","Query exceeding 512 characters is rejected","Invalid content type enum value returns an error","Invalid region code may return no localized results or an error","Invalid cursor value may return an error or reset to first page","Payment not included or insufficient funds returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need to programmatically search YouTube by keyword and want control over content type (videos, shorts, channels, playlists), region, recency, duration, and sort order. Prefer it over scraping YouTube directly or using the official YouTube Data API when you want a simple pay-per-call interface without OAuth or quota management.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:55:41.927Z","isFirstParty":false}