{"uid":"cap_NjK96Kf1LGxxCg6xkk3bi","slug":"api-direct-tiktok-video-search-dcd42fee","name":"API Direct – TikTok Video Search","description":"Search for TikTok videos by keyword.","url":"https://x402.apidirect.io/v1/tiktok/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":["query"],"properties":{"pages":{"type":"integer","default":1,"maximum":10,"minimum":1,"description":"Number of pages to fetch and merge (1-10). Each page returns up to 30 videos. Billed per page."},"query":{"type":"string","maxLength":500,"description":"Search query (max 500 characters)"},"region":{"type":"string","maxLength":2,"minLength":2,"description":"2-letter region code to filter by (e.g., us, gb, jp, de, fr)"},"sort_by":{"enum":["relevance","most_recent","most_liked"],"type":"string","default":"relevance","description":"Sort order for results. Any unrecognised value falls back to relevance."},"publish_time":{"enum":[0,1,7,30,90,180],"type":"integer","default":0,"description":"Filter by publish time in days: 0 = all time, 1 = last day, 7 = last week, 30 = last month, 90 = last 3 months, 180 = last 6 months. Any other number returns 400; a non-numeric value falls back to 0."},"get_sentiment":{"type":"boolean","default":false,"description":"Set to true to add AI emotion analysis to each video. 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 video"}}}},"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_IKHvvsKhkc6gKYm_mCh-x","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":"Search TikTok for videos by keyword, with optional filters for region, recency, sort order, and AI sentiment analysis.","exampleAgentPrompt":"Search TikTok for videos about 'sustainable fashion' posted in the last 30 days, sorted by most liked, and include AI emotion analysis for each result — fetch 2 pages and filter to US content.","exampleUseCases":[{"title":"Brand sentiment monitoring on TikTok","prompt":"Search TikTok for videos mentioning 'Nike running shoes' from the last 7 days in the US, sorted by most recent, and include the sentiment analysis so I can see how people are feeling about the brand."},{"title":"Viral content research for a campaign","prompt":"Find the most liked TikTok videos about 'matcha latte' from all time — give me 3 pages of results so I have a solid sample to understand what's going viral."},{"title":"Regional trend discovery for a market","prompt":"Search TikTok for videos about 'electric vehicles' in Germany over the last 3 months, sorted by relevance, so I can understand what EV content is resonating with German audiences."}],"resultDescription":"Returns a merged list of TikTok videos (up to 30 per page, up to 10 pages) matching the keyword query, including video metadata such as title, author, view counts, and links. When get_sentiment is true, each video also includes a sentiment object with emotion scores (joy, trust, fear, surprise, sadness, disgust, anger, anticipation each 0-100), a dominant_emotion label, emotional_intensity (0-10), and a polarity label (positive, negative, or neutral).","failureModes":["Invalid or missing query parameter returns 400","publish_time value not in the allowed enum (0,1,7,30,90,180) returns 400","region code not exactly 2 characters returns 400","Unrecognised sort_by value falls back silently to relevance","pages value outside 1-10 range returns 400","TikTok rate limits or availability issues may return 5xx errors","No results found for obscure queries returns empty list"],"whenToPreferThis":"Use this endpoint when you need to programmatically search TikTok video content by keyword, especially when you want flexible filtering by region, recency, or engagement, or when you need AI-powered emotion/sentiment analysis layered on top of the results. Prefer it over manual TikTok browsing or scraping for agent workflows that need structured video data, trend monitoring, or brand sentiment tracking on TikTok specifically. It is billed per page, so it is cost-efficient for targeted searches.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:08:07.239Z","isFirstParty":false,"canonicalSlug":"api-direct-tiktok-video-search-dcd42fee"}