{"uid":"cap_WCsd0K_eJE2M151xE53o8","slug":"tiktok-video-search-41174bb2","name":"TikTok Video Search","description":"TikTok Video Search: search public TikTok videos by keyword or hashtag. Per video the caption, creator handle, name, verification and followers, plays, likes, comments, shares, cover image link, time and URL in the shared social schema; next_cursor gives the next page. Trend and hashtag research. Bad input is free; not found or no match is not charged.","url":"https://social.duoleads.com/v1/tiktok/search?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"],"type":"string"},"queryParams":{"type":"object","required":["q"],"properties":{"q":{"type":"string","maxLength":200,"description":"Search text (1-200 characters)."},"cursor":{"type":"string","maxLength":512,"description":"next_cursor of the previous page."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"as_of":"2026-10-15T12:00:00.000Z","items":[{"id":"7000000000000000101","url":"https://www.tiktok.com/@synth_unboxer/video/7000000000000000101","lang":"en","text":"synthwidget unboxing","type":"video","author":{"handle":"synth_unboxer","verified":false,"followers":1476,"display_name":"Synth Unboxer"},"metrics":{"likes":4816,"views":128264,"replies":187,"reposts":272},"platform":"tiktok","parent_id":null,"created_at":"2026-10-11T06:26:40.000Z","media_urls":["https://p16.tiktokcdn.invalid/cover/101.jpeg"]}],"query":{"q":"synthetic widgets","cursor":null},"source":"public data via third-party provider; not affiliated with the platform","complete":true,"platform":"tiktok","disclaimer":"Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.","request_id":"01KEXAMPLE0000000000000000","next_cursor":"12"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_7m5XVpBO-jIzxUp_Fc_eM","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search public TikTok videos by keyword or hashtag, returning per-video captions, creator details, engagement metrics, and cover images with pagination support.","exampleAgentPrompt":"Search TikTok for videos about 'sustainable fashion' and show me the top results with their view counts, creator handles, and captions.","exampleUseCases":[{"title":"Brand mention monitoring on TikTok","prompt":"Search TikTok for videos mentioning 'NovaBrew coffee' and list each video's URL, caption, creator handle, follower count, and how many views and likes it got."},{"title":"Hashtag trend research","prompt":"Find me the latest TikTok videos using the hashtag 'cottagecore' — I want to see who's posting, how many followers they have, and which videos are getting the most plays."},{"title":"Competitor content analysis","prompt":"Search TikTok for videos about 'wireless earbuds review' and pull back the captions, creator details, and engagement numbers so I can see what content is resonating most."}],"resultDescription":"Returns a paginated list of public TikTok videos matching the query. Each item includes: video ID, URL, language, caption text, type, author object (handle, display name, verified status, follower count), metrics (likes, views, replies, reposts), platform tag, creation timestamp, and cover image URLs. Also includes the original query echoed back, a next_cursor for pagination, a request ID, and a disclaimer about data sourcing.","failureModes":["Bad or malformed query input is free (not charged)","No results found for query returns empty items array (not charged)","Invalid cursor value may return an error or restart pagination","Rate limiting or quota exhaustion may return HTTP 429","Network or provider downtime returns HTTP 5xx"],"whenToPreferThis":"Choose this endpoint when you need to search TikTok specifically by keyword or hashtag and require per-video engagement metrics alongside creator metadata. Prefer it over the multi-platform Social Search endpoint when you only need TikTok data and want the full detail available in TikTok-specific fields. Use TikTok Profile & Videos instead if you already know the creator's handle and want their video feed rather than a keyword search.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:33:48.816Z","isFirstParty":false,"canonicalSlug":"tiktok-video-search-41174bb2"}