{"code":"ok","data":{"revision":"c48ce454ae6c4c65","prices":{"version":"2","effective_at":"2026-10-17T11:00:33.380Z","currency":"USD"},"capability":{"id":"tiktok.videos.search","category":"social","role":"posts.search","name":{"zh":"TikTok 视频搜索","en":"TikTok video search"},"summary":{"zh":"按关键词搜索 TikTok 视频，每页 30 条，可按相关度、点赞数或发布时间排，可限定发布时间。","en":"Search TikTok videos by keyword, 30 a page; sort by relevance, likes or time posted, and limit how recently they were posted."},"aliases":{"zh":["TikTok 关键词搜索","搜 TikTok 视频"],"en":["tiktok keyword search","search tiktok videos"]},"params":{"query":{"required":true,"example":"space station"},"sort":{"doc":{"zh":"按相关度、点赞数或发布时间排","en":"By relevance, by likes, or newest first"},"values":["relevance","popular","latest"],"default":"relevance","example":"relevance"},"published_within":{"doc":{"zh":"只要最近这段时间发布的","en":"Only videos posted within this period"},"values":["day","week","month","half_year"],"example":"week"}},"object":"post","shape":"items","unavailable":{"title":"platform","images":"capability","author.verified":"capability","metrics.reposts":"capability","mentions.username":"capability","mentions.name":"capability","post_id":"platform","parent_id":"platform","root_id":"platform","is_pinned":"capability"},"ext":["duration","cover_url","video_url"],"page":{"typical":30,"max":30,"cursor_ttl_seconds":3600},"methods":["GET"],"path":"/v1/tiktok/videos/search","namespace":"tiktok","action":"search","stability":"stable","request_params":["query","sort","published_within","cursor","view","fields"],"examples":[{"method":"GET","path":"/v1/tiktok/videos/search","params":{"query":"space station"}}],"pricing":{"per":"call","price":"0.002","max_charge":"0.002","charge_when_empty":"0.002"},"example_responses":[{"state":"data","source":"recorded","items":30,"body":{"code":"ok","request_id":"00000000-0000-4000-8000-000000000001","data":{"items":[{"id":"…","url":"https://example.com/…","type":"video","text":"…","lang":"en","published_at":"2026-10-11T23:17:34.000Z","author":{"id":"…","username":"…","name":"…","avatar_url":"https://example.com/…","followers":92601},"metrics":{"likes":353,"comments":11,"shares":19,"favorites":40,"views":7561},"hashtags":["…","…"],"mentions":[]}]},"page":{"next_cursor":"example-cursor-1","cursor_expires_at":"2026-10-12T20:17:24.000Z","has_more":true,"returned":30},"warnings":[],"meta":{"capability":"tiktok.videos.search","result_status":"complete","fetched_at":"2026-10-12T19:17:24.000Z","cached":false,"replayed":false,"unavailable":{"title":"platform","images":"capability","author.verified":"capability","metrics.reposts":"capability","mentions.username":"capability","mentions.name":"capability","post_id":"platform","parent_id":"platform","root_id":"platform","is_pinned":"capability"},"billing":{"amount":"0.002","currency":"USD","balance_after":"9.998"}}},"elided":{"data.items":29,"data.items.0.hashtags":2},"bytes":{"compact":21448,"standard":35349,"full":59603}},{"state":"empty","source":"altered","items":0,"body":{"code":"ok","request_id":"00000000-0000-4000-8000-000000000001","data":{"items":[]},"page":{"next_cursor":null,"cursor_expires_at":null,"has_more":false,"returned":0},"warnings":[],"meta":{"capability":"tiktok.videos.search","result_status":"empty","fetched_at":"2026-10-12T19:17:24.000Z","cached":false,"replayed":false,"unavailable":{"title":"platform","images":"capability","author.verified":"capability","metrics.reposts":"capability","mentions.username":"capability","mentions.name":"capability","post_id":"platform","parent_id":"platform","root_id":"platform","is_pinned":"capability"},"billing":{"amount":"0.002","currency":"USD","balance_after":"9.998"}}},"elided":{},"bytes":{"compact":657,"standard":657,"full":657}}],"item_bytes":{"compact":674,"standard":1155,"full":1964},"example_problems":["query is required"]},"live":{"as_of":"2026-10-21T10:16:12.000Z","status":"available"}}}