{"uid":"cap_VwaKTkBa6eQLhJGBpjEJf","slug":"stablesocial-youtube-search-25bcd253","name":"StableSocial YouTube Search","description":"Pay-per-request access to social media data from TikTok, Instagram, Facebook, Reddit, and LinkedIn. No auth, no subscriptions.","url":"https://stablesocial.dev/api/sc/youtube/search","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"type":{"enum":["videos","shorts","channels","playlists"],"type":"string","description":"Type of content to search for"},"query":{"type":"string","minLength":1,"description":"Search query"},"region":{"type":"string","description":"2 letter country code of the country to put the proxy in."},"sortBy":{"enum":["relevance","popular"],"type":"string","description":"Sort by"},"duration":{"enum":["under_3_min","between_3_and_20_min","over_20_min"],"type":"string","description":"Duration of the video. Only applies to videos (not shorts)."},"uploadDate":{"enum":["today","this_week","this_month","this_year"],"type":"string","description":"Upload date"},"includeExtras":{"type":"string","description":"This will get you the like + comment count and the description. To get the full details of the video, use the /v1/youtube/video endpoint. *This will slow down t"},"continuationToken":{"type":"string","description":"Continuation token to get more videos. Get 'continuationToken' from previous response."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.06","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.06/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_7x7MFL4AaTPhXZppFfsFO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.06","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, shorts, channels, or playlists by keyword with optional filters for region, sort order, duration, and upload date","exampleAgentPrompt":"Search YouTube for videos about 'electric vehicle reviews' uploaded this month, sorted by popularity, and include like and comment counts — I want videos only, not shorts or channels.","exampleUseCases":[{"title":"Trending topic research for content creators","prompt":"Find the most popular YouTube videos about 'AI image generation' uploaded this week, sorted by popularity, and give me the like and comment counts so I can see what's getting traction."},{"title":"Competitor channel discovery","prompt":"Search YouTube for channels related to 'personal finance for millennials' — I want to see who the big players are in that space, sorted by relevance."},{"title":"Short-form video trend analysis","prompt":"Search YouTube Shorts for 'gym workout tips' uploaded today in the US — show me what's trending right now with engagement stats included."}],"resultDescription":"Returns a list of YouTube search results matching the query, typed by the requested content category (videos, shorts, channels, or playlists). Each result includes title, URL, thumbnail, channel info, view count, and publish date. When includeExtras is set, results also include like count, comment count, and description. A continuationToken is provided to fetch the next page of results.","failureModes":["Empty results if the query returns no matches for the given filters","Invalid region code returns an error or falls back to default region","Expired or invalid continuationToken causes pagination to fail","Duration filter ignored when searching shorts (only applies to videos)","Rate-limited or blocked by YouTube, returning incomplete or empty results","Missing required 'query' field returns a validation error"],"whenToPreferThis":"Use this endpoint when you need programmatic, pay-per-request YouTube search without managing API keys or OAuth. It is ideal for agents that need to discover YouTube content on demand, perform trend research, or build content pipelines without committing to a subscription. Prefer this over the YouTube Data API when you want zero-auth simplicity, need residential proxy routing via region codes, or want to avoid quota management.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:58:52.376Z","isFirstParty":false}