{"uid":"cap_8CA0OJDdzmSSwVdKTeED2","slug":"tiktok-playlist-videos-c023e24c","name":"TikTok Playlist Videos","description":"Get a playlist's videos in playlist order by playlist URL or numeric playlist ID.","url":"https://x402.apidirect.io/v1/tiktok/playlist/videos?utm_source=zero.xyz","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"url":{"type":"string","maxLength":500,"description":"TikTok playlist URL, e.g. https://www.tiktok.com/@natgeo/playlist/Cinematic-7509464647364283178 (max 500 characters). Provide exactly one of url or playlist_id."},"pages":{"type":"integer","default":1,"maximum":1000,"minimum":1,"description":"Number of pages to fetch, 1-1000 (default: 1). Each page returns up to 30 videos."},"playlist_id":{"type":"string","description":"Numeric playlist ID: the number at the end of a playlist URL. Provide exactly one of url or playlist_id."},"get_sentiment":{"type":"boolean","default":false,"description":"Set to true to add AI emotion analysis to each item. Adds a `sentiment` object containing `emotions` (joy, trust, fear, surprise, sadness, disgust, anger and anticipation, each scored 0-100), `dominant_emotion`, `emotional_intensity` (0-10), and `polarity` (positive, negative or neutral). Any item t"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.007","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.007/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2xfrDT6dq3DmOZH-qjDp-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.007","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches all videos in a TikTok playlist in order, by playlist URL or numeric playlist ID, with optional AI sentiment analysis per video.","exampleAgentPrompt":"Pull all the videos from this TikTok playlist — https://www.tiktok.com/@natgeo/playlist/Cinematic-7509464647364283178 — and include the AI sentiment analysis for each video so I can see the emotional tone.","exampleUseCases":[{"title":"Audit a creator's playlist content","prompt":"Get me all the videos from this TikTok playlist: https://www.tiktok.com/@natgeo/playlist/Cinematic-7509464647364283178 — I want to see every video in order so I can audit the content."},{"title":"Sentiment analysis on playlist videos","prompt":"Fetch the videos from TikTok playlist ID 7509464647364283178 and turn on the sentiment analysis so I can see the emotional breakdown — joy, sadness, anger, etc. — for each video."},{"title":"Monitor playlist updates over time","prompt":"Grab the first 3 pages of videos from this TikTok playlist — https://www.tiktok.com/@fitnessbrand/playlist/Workouts-1234567890 — so I can track what's been added recently."}],"resultDescription":"Returns an ordered list of videos in the specified TikTok playlist, up to 30 videos per page, including video metadata. When sentiment is enabled, each video item includes a sentiment object with emotion scores (joy, trust, fear, surprise, sadness, disgust, anger, anticipation each 0–100), dominant_emotion, emotional_intensity (0–10), and polarity (positive, negative, or neutral).","failureModes":["Invalid or expired TikTok playlist URL returns an error or empty result","Private or deleted playlists may return no videos","Both url and playlist_id provided simultaneously causes a validation error","Neither url nor playlist_id provided causes a required parameter error","Requesting too many pages may hit rate or timeout limits","Playlist ID that doesn't exist returns empty or error response"],"whenToPreferThis":"Use this endpoint when you need ordered video listings from a specific TikTok playlist, especially when you want pagination control (up to 1000 pages of 30 videos each) or per-video AI emotion/sentiment analysis. Prefer this over generic social media scrapers when the use case is specifically TikTok playlist traversal. If you only need a single video's details rather than a full playlist, use a video detail endpoint instead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:06:07.243Z","isFirstParty":false,"canonicalSlug":"tiktok-playlist-videos-c023e24c"}