{"uid":"cap_WCxr4IgB11U9MNMeH_aGB","slug":"tiktok-user-liked-videos-408a12a3","name":"TikTok User Liked Videos","description":"Get the videos a user has liked, by username, numeric user ID, or profile URL.","url":"https://x402.apidirect.io/v1/tiktok/user/likes?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__FD3Um6T87rHWoPrLqHx7","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":"Retrieves the list of videos a TikTok user has publicly liked, identified by username, numeric user ID, or profile URL.","exampleAgentPrompt":"Can you pull the liked videos for TikTok user @charlidamelio — grab the first 3 pages and include AI sentiment analysis on each video?","exampleUseCases":[{"title":"Brand affinity research on TikTok","prompt":"Fetch the liked videos for TikTok user @addisonre and tell me what topics and brands keep showing up — I want to understand her content preferences."},{"title":"Competitor audience taste analysis","prompt":"Get 5 pages of liked videos for TikTok user ID 123456789 and include the sentiment analysis so I can see what emotional tone of content resonates with this account."},{"title":"Influencer vetting for partnerships","prompt":"Pull the liked videos for the TikTok profile at https://www.tiktok.com/@bealivegirl so I can review what kind of content they engage with before we sign them for a campaign."}],"resultDescription":"Returns paginated lists of TikTok videos that the specified user has publicly liked, with each video object containing metadata (title, video ID, author, engagement stats, etc.). If sentiment analysis is enabled, each item also includes a `sentiment` object with emotion scores (joy, trust, fear, surprise, sadness, disgust, anger, anticipation each 0–100), a dominant emotion, emotional intensity (0–10), and polarity (positive, negative, or neutral). Each page contains up to 30 videos.","failureModes":["User not found or account is private — returns error with no results","Username/user_id/url not provided or multiple identifiers provided — validation error","TikTok profile has no public likes — returns empty list","Pagination beyond available liked videos — returns partial or empty page","Rate limiting or TikTok access restrictions — upstream timeout or error response","Invalid page count (outside 1–1000 range) — schema validation error"],"whenToPreferThis":"Use this endpoint when you need to programmatically retrieve the public liked videos of a specific TikTok user and optionally layer AI-based emotion analysis on top. It is ideal for influencer research, audience taste profiling, brand safety checks, and competitive intelligence. Prefer it over TikTok's own API when you need simple username/URL-based lookup without OAuth, or when sentiment enrichment is needed inline.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:05:55.245Z","isFirstParty":false,"canonicalSlug":"tiktok-user-liked-videos-408a12a3"}