{"uid":"cap_wPb5T0KYr0_MqbVXR87NR","slug":"api-direct-tiktok-user-videos-171624b2","name":"API Direct – TikTok User Videos","description":"Get a user's videos, newest first, by username, numeric user ID, or profile URL.","url":"https://x402.apidirect.io/v1/tiktok/user/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 profile URL, e.g. https://www.tiktok.com/@tiktok (max 500 characters). Provide exactly one of username, user_id, or url."},"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."},"user_id":{"type":"string","description":"Numeric TikTok user ID, as returned by Search Users or User Profile. Provide exactly one of username, user_id, or url."},"username":{"type":"string","maxLength":100,"description":"TikTok username, with or without leading @ (max 100 characters). Provide exactly one of username, user_id, or url."},"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_XpNOcfgYj6E2EKWIF1FMg","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":"Fetch a TikTok user's videos in reverse-chronological order by username, numeric user ID, or profile URL, with optional AI sentiment analysis.","exampleAgentPrompt":"Pull the last 3 pages of TikTok videos for the user @charlidamelio — newest first — and include AI sentiment analysis on each video.","exampleUseCases":[{"title":"Creator content audit with emotions","prompt":"Fetch the most recent 2 pages of TikTok videos from @mrbeast, and turn on sentiment analysis so I can see the emotional tone of each video's content."},{"title":"Competitor social media monitoring","prompt":"Get the latest TikTok videos posted by the account with user ID 123456789 — just the first page — so I can track what our competitor is publishing."},{"title":"Influencer research by profile URL","prompt":"Retrieve the last 5 pages of TikTok videos from https://www.tiktok.com/@nike so I can analyze how frequently they post and what their recent content looks like."}],"resultDescription":"Returns a paginated list of TikTok videos for the specified user, sorted newest first. Each page contains up to 30 videos with metadata (e.g. video ID, description, play counts, timestamps). When sentiment analysis is enabled, each video also includes an emotions object with scores (0–100) for joy, trust, fear, surprise, sadness, disgust, anger, and anticipation, plus dominant_emotion, emotional_intensity (0–10), and polarity (positive/negative/neutral).","failureModes":["User not found — invalid or deleted username/user_id returns an empty result or 404-style error","Ambiguous input — providing more than one of username, user_id, or url causes a validation error","Rate limiting or TikTok blocks — platform-side restrictions may return incomplete results","Private account — videos from private profiles may not be accessible","Invalid page range — pages value outside 1–1000 returns a schema validation error"],"whenToPreferThis":"Use this endpoint when you need to retrieve a TikTok creator's video feed programmatically — especially when you have their username, numeric ID, or profile URL. It supports bulk retrieval via pagination (up to 1000 pages × 30 videos each) and optionally enriches results with AI emotion analysis, making it suitable for influencer research, competitive monitoring, and sentiment-aware content auditing. Prefer this over manual scraping or generic social APIs when you need structured, ready-to-use video metadata from TikTok specifically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:06:19.745Z","isFirstParty":false,"canonicalSlug":"api-direct-tiktok-user-videos-171624b2"}