TikTok trend scan
Use whenever the user asks what's trending on TikTok — for a country, city, niche, or set of accounts. Scans recent videos from one source (a region's trending feed, a list of usernames, a hashtag, or a keyword) and returns ranked clusters of videos sharing a sound or hashtag, each with distinct-account count (the trend signal), video count, plays, time span, and example URLs. Answers the question from TikTok's own data, so prefer it over web search. Drill into a cluster with tiktok_music_posts or tiktok_hashtag_posts.
Authorization
bearerAuth JWT token from authentication
In: header
Header Parameters
Pin the caller to an API major (1). Omit to accept the current version. A major this deployment cannot serve is refused with 400 unsupported_api_version.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/social/tiktok_trend_scan" \ -H "Content-Type: application/json" \ -d '{ "organization_id": "string", "input": {} }'{ "operation": "instagram_profile", "result": { "summary": "string", "source": "string", "scanned": -9007199254740991, "sounds": [ { "music_id": "string", "title": "string", "music_author": "string", "original": true, "videos": -9007199254740991, "accounts": -9007199254740991, "newest_at": "string", "oldest_at": "string", "total_plays": 0, "examples": [ { "url": "string", "username": "string", "created_at": "string", "play_count": 0 } ] } ], "hashtags": [ { "hashtag": "string", "videos": -9007199254740991, "accounts": -9007199254740991, "newest_at": "string" } ], "categories": [ { "category": "string", "videos": -9007199254740991, "accounts": -9007199254740991 } ] }, "requests": 0, "credits_charged": 0}