{"uid":"cap_yRzVFy5FhPt8Cxd1in2R9","slug":"socialfetch-youtube-playlist-lookup-b495b555","name":"SocialFetch YouTube Playlist Lookup","description":"Get a YouTube playlist by playlist id.","url":"https://api.socialfetch.dev/v1/youtube/playlists","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":["playlistId"],"properties":{"playlistId":{"type":"string","maxLength":4096,"minLength":1,"description":"YouTube playlist id, or a YouTube playlist URL (the `list` query value is used when present)."}}}},"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":1,"rating":{"score":"1.00","successRate":"1.00","reviews":1,"stars":"5.0","state":"rated"},"availabilityStatus":"healthy","priceObserved":{"p10Cents":"1.4000","medianCents":"1.4000","p90Cents":"1.4000","minCents":"1.4000","maxCents":"1.4000","p95Cents":"1.4000","sampleCount":2,"varies":false,"failureChargeRate":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_biyHgrQRut-cgcAD7jUFx","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":"Fetches metadata and contents of a YouTube playlist given its playlist ID or URL.","exampleAgentPrompt":"Can you pull up the details and video list for this YouTube playlist? The playlist ID is PLbpi6ZahtOH6Ar_3GPy3workpGRMfQ5_U.","exampleUseCases":[{"title":"Curate content library from creator playlist","prompt":"I want to build a content calendar from a YouTuber's uploads playlist. Can you grab all the videos from their playlist and show me the titles, descriptions, and order so I can plan our discussion around it?"},{"title":"Verify playlist contents before sharing","prompt":"Before I share this playlist link with my team, can you fetch what's actually in it? I want to see the video list and make sure all the content is still relevant and appropriate."},{"title":"Extract playlist metadata for documentation","prompt":"We're documenting our course materials and need the YouTube playlist details. Can you pull the playlist title, description, and full video list from this URL so I can include it in our resource guide?"}],"resultDescription":"Returns structured data about the YouTube playlist including playlist title, description, video entries, channel/creator info, and other playlist-level metadata.","failureModes":["Invalid or malformed playlist ID returns an error","Playlist is private or deleted and cannot be accessed","Missing required playlistId query parameter returns a validation error","Rate limiting or payment failure results in a 402 response","YouTube API backend is unavailable causing a timeout"],"whenToPreferThis":"Use this endpoint when you need to retrieve playlist-level metadata and video listings from YouTube given a playlist ID or playlist URL. Prefer this over general YouTube search endpoints when you already have the playlist identifier and need structured playlist data without manual scraping.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":2,"lastUsedAt":"2026-08-17T19:40:39.487Z","lastSuccessfullyRanAt":"2026-08-17T19:40:39.487Z","lastHealthCheckAt":"2026-09-14T12:32:41.063Z","isFirstParty":false}