# TikTok Breakout Sound, Music & Hashtag Trend Velocity Radar (`church_of_loujess/tiktok-sound-trend-radar`) Actor Spot breakout TikTok sounds, songs, and niche hashtags before they peak. Computes Sound Velocity Scores (0-100), 7-day upload acceleration, original vs. commercial music flags, MP3 preview URLs, co-occurring hashtags, and top viral videos. - **URL**: https://apify.com/church_of_loujess/tiktok-sound-trend-radar.md - **Developed by:** [H H](https://apify.com/church_of_loujess) (community) - **Categories:** Social media, Marketing, AI - **Security:** Limited permissions - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $8.00 / 1,000 analyzed tiktok sound & velocity trend reports This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ### What can TikTok Sound & Trend Velocity Radar do? **TikTok Sound & Trend Velocity Radar** detects rising TikTok audio tracks, original sounds, commercial songs, and co-occurring hashtag clusters before they peak — computing **Sound Velocity Scores (`0–100`), 24-hour & 7-day upload acceleration (`postsLast24HoursPct`, `postsLast7DaysPct`), trend lifecycle stage, original-vs-commercial licensing flags (`isOriginalSound`), playable MP3 preview URLs, and top breakout sample videos** in **256 MB RAM**:
📦 What you can extract ⚙️ Features & integrations
📈 **Sound Velocity Score (`0–100`)** (`velocityScore`, `trendStage` — `breakout_surge`, `rising_momentum`, `established_hit`)
⏱️ **24h & 7d upload acceleration** (`postsLast24HoursPct`, `postsLast7DaysPct`, `uniqueCreatorsInSample`)
🎵 **Audio & licensing metadata** (`musicId`, `musicTitle`, `musicArtist`, `isOriginalSound`, `durationSec`)
🔊 **Playable MP3 & cover URLs** (`audioPreviewUrl`, `coverUrl`, `soundPageUrl`)
\#️⃣ **Co-occurring hashtag clusters** (`coOccurringHashtags[]`) showing the exact niche trend paired with the audio
🎬 **Top breakout sample videos** (`topBreakoutVideos[]`, `avgViewsSample`, `avgEngagementRatePct`) 		🔎 **Niche scan OR direct Sound IDs** discover sounds by `keywords` OR track known `soundIds`
🏢 **Brand-safe audio filtering** use `isOriginalSound` to separate royalty-risk music from creator audio
⚡ **Zero proxy cost in 256 MB** queries `/api/music/item_list/` feeds directly with zero browser overhead
📅 **Built for daily cron radar** spot A\&R music surges & social audio memes 7–14 days early
⬇️ **Export trend reports** to JSON, CSV, Excel, Slack, Airtable, Spotify/A\&R trackers or Notion
🤖 **Native MCP companion** also live on our Standby `tiktok-intelligence-mcp` server
Public TikTok sound leaderboards only show giant Top-40 songs *after* 500,000 videos have already saturated them. TikTok Sound & Trend Velocity Radar scans **niche-specific audio** (`"gym motivation"`, `"aesthetic vlog"`, `"indie pop"`, `"booktok"`) and inspects each sound's live video feed to measure real recency velocity. ### What data can I extract with TikTok Sound & Trend Velocity Radar? For music labels, A\&R scouts, social media managers, and short-form editors, every record delivers quantitative audio momentum: - **Velocity scoring & lifecycle stage:** *distinguish fresh breakouts from legacy evergreens*. Samples the sound's active video feed (`includeSampleVideos: true`) to compute `velocityScore` (`0`–`100`), `trendStage`, `postsLast24HoursPct`, `postsLast7DaysPct`, `sampleVideosAnalyzed`, `uniqueCreatorsInSample`, `avgViewsSample`, and `avgEngagementRatePct`. - **Track identity, commercial safety & MP3 preview:** *instant audio auditioning*. Returns `musicId`, `musicTitle`, `musicArtist`, `musicAlbum`, `isOriginalSound` (`true` for creator original audio/memes, `false` for licensed catalog tracks), `durationSec`, `audioPreviewUrl`, `coverUrl`, and canonical `soundPageUrl`. - **Format context (`coOccurringHashtags` + `topBreakoutVideos`):** *see how creators actually edit to the beat*. Lists the top hashtags paired with the track plus `topBreakoutVideos[]` so creative teams can watch the exact visual meme format immediately. > Need more specialized workflows? Combine this Actor with these dedicated tools from our suite: > > - 🔌 [TikTok Intelligence MCP Server](https://apify.com/church_of_loujess/tiktok-intelligence-mcp): call `scan_breakout_tiktok_sounds` live inside Claude Desktop, ChatGPT, or Cursor > - 🎣 [TikTok Viral Hook & Script Scraper](https://apify.com/church_of_loujess/tiktok-viral-hook-script-scraper): pair rising background audio with proven 3.5-second spoken hooks > - 📈 [Google Trends Scraper](https://apify.com/church_of_loujess/google-trends-fast-scraper): check whether a breakout TikTok song/artist is crossing over into Google Search surges > - 🔎 [TikTok Search Scraper](https://apify.com/church_of_loujess/tiktok-search-scraper): run full video discovery seeded with `music` expansion pools ### How much will TikTok Sound & Trend Velocity Radar cost? TikTok Sound & Trend Velocity Radar uses a transparent **Pay-Per-Event (PPE)** pricing model, where you pay a tiny `$0.05` **Actor Start** event plus a per-item fee for each **Analyzed TikTok Sound & Velocity Trend Report**. On the Apify Free plan (`$5.00` monthly free credit included), it costs **$0.02 per item ($20.00 per 1,000 results)** — letting you extract up to **247 results every month for free**. Paid Apify plans automatically unlock volume discounts up to **60% off** ($0.012 on Starter/Bronze, $0.01 on Scale/Silver, and **$0.008** on Business/Gold, Platinum & Diamond) with zero residential proxy surcharges: | Apify Plan / Tier | Price per extracted dataset item | Price per 1,000 results | Included Monthly Credit | Approx. Monthly Capacity | | :--- | :--- | :--- | :--- | :--- | | **Free (`FREE`)** | `$0.02` | `$20.00` | `$5.00 / mo` | **~247** results | | **Starter (`BRONZE`)** | `$0.012` | `$12.00` | `$29.00 / mo` | **~2,412** results | | **Scale (`SILVER`)** | `$0.01` | `$10.00` | `$199.00 / mo` | **~19,895** results | | **Business (`GOLD`)** | `$0.008` | `$8.00` | `$999.00 / mo` | **~124,868** results | | **Enterprise (`PLATINUM` / `DIAMOND`)** | `$0.008` / `$0.008` | `$8.00` | Custom | Custom high-volume SLA | > **Cost-control tip:** Batch multiple URLs, handles, or keywords into a single run so the `$0.05` `Actor Start` event is amortized once across your entire batch. You can also set a hard **Maximum cost per run** cap directly in Apify Console. Check the [pricing tab](https://apify.com/church_of_loujess/tiktok-sound-trend-radar/pricing) for full details. ### How do I use TikTok Sound & Trend Velocity Radar? TikTok Sound & Trend Velocity Radar was designed to be effortless to start with — even if you have never configured proxies, cookies, or web scrapers before. Here is how to extract data in under a minute: 1. [Create](https://console.apify.com/sign-up) a free Apify account using your email (includes `$5.00` in monthly free usage credit). 2. Open **[TikTok Sound & Trend Velocity Radar](https://console.apify.com/actors/g3ysxCAaMqMXd0K65)** in Apify Console. 3. Configure your target inputs (`keywords`, `soundIds`, `maxTrends`) in the **Input** tab (use **Bulk edit** to paste lists at once). 4. Adjust your results limit or optional enrichment filters to match your workflow. 5. No proxy setup is required — the Actor runs directly in a fast **256 MB** container out of the box. 6. Click **Save & Start** and watch structured records stream into your Dataset in real time. 7. Open the **Storage** tab to inspect your results as a clean table or raw JSON. 8. Download your dataset in **JSON, CSV, Excel (`.xlsx`), or XML**, or connect it directly to **Clay, n8n, Make, Zapier, Google Sheets, or MCP**. ### ⬇️ Input Discover niche audio via **`keywords`**, benchmark specific tracks via **`soundIds`** (numeric IDs or `tiktok.com/music/...` URLs), **or combine both**. #### Mode 1: Niche & Genre Breakout Audio Discovery (`keywords`) Scans niche search feeds, extracts unique audio tracks driving viral videos, and computes 24h/7d upload velocity. | Input / Configuration | What it returns | | :--- | :--- | | `keywords: ["gym motivation", "aesthetic vlog", "indie pop"]` | Ranked sound trends + `velocityScore` + MP3 previews + sample videos | **Input JSON example:** ```json { "keywords": [ "gym motivation", "aesthetic vlog", "dark academia" ], "maxTrends": 20, "includeSampleVideos": true } ``` #### Mode 2: Record-Label / Campaign Sound ID Velocity Tracker (`soundIds`) Track daily velocity, creator adoption, and average view performance on your artist's or brand's official TikTok sound IDs. | Input / Configuration | What it returns | | :--- | :--- | | `soundIds: ["7634880283891796758", "https://www.tiktok.com/music/..."]` | Live feed velocity + top breakout creator videos using that exact sound | **Input JSON example:** ```json { "keywords": [], "soundIds": [ "7634880283891796758" ], "maxTrends": 10, "includeSampleVideos": true } ``` #### Complete Input Parameter Reference | Parameter | Type | Default | Required | Description | | :--- | :--- | :--- | :--- | :--- | | `keywords` | `array` | `["gym motivation", "aesthetic vlog"]` | No | Niches or genres to scan for rising TikTok audio tracks and breakout sounds (e.g. 'gym motivation', 'aesthetic vlog', 'indie pop'). | | `soundIds` | `array` | `[]` | No | Optional specific TikTok sound IDs or music URLs to analyze velocity for. | | `maxTrends` | `integer` | `15` | No | Maximum number of analyzed trending sounds to output. | | `includeSampleVideos` | `boolean` | `true` | No | Fetch the sound's feed (/api/music/item_list/) to compute 7-day upload velocity and include top viral example videos. | ### ⬆️ Output and setup All extracted records stream incrementally into your run's **Dataset** under the **Storage** tab in Apify Console. Preview results as a clean interactive table, download in **JSON, JSONL, CSV, Excel (`.xlsx`), XML, or RSS**, or consume items directly via the Apify REST API, Python/Node.js SDKs, or MCP. #### 📦 Verified dataset output sample ```json { "musicId": "7634880283891796758", "musicTitle": "originalljud - Admiring Beauty", "musicArtist": "Admiring Beauty", "musicAlbum": null, "discoveryKeyword": "gym motivation", "trendStage": "established_hit", "velocityScore": 48, "postsLast24HoursPct": 0, "postsLast7DaysPct": 0, "sampleVideosAnalyzed": 1, "uniqueCreatorsInSample": 1, "avgViewsSample": 6500000, "avgEngagementRatePct": 21.37, "isOriginalSound": true, "durationSec": 20, "audioPreviewUrl": "https://v16m.tiktokcdn-us.com/fa18c4387bdaaaf1860875277333d7f4/6ae8a599/video/tos/no1a/tos-no1a-v-2370-no/o44fyILMB85LSAEqwivvB5FtwiAKD0CKO5zEww/?a=1233&bti=ODszNWYuMDE6&&bt=125&ft=GSDrKInz7ThyVwAGXq8Zmo&mime_type=audio_mpeg&rc=Z2ZoaGUzN2U1MzdkNWk1O0BpamRtNXM5cmU7OjMzbzU8NUBgNjQtMjQuXi0xLy0zY2I1YSNtLmstMmRram5hLS1kMTFzcw%3D%3D&vvpl=1&l=20261102090020E54D1...", "coverUrl": "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/cc9e020fa09bc35e3d01c74506e7618f~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=dc0fa140&x-expires=1793782800&x-signature=Ml%2B2zUrhigDw%2FI71rl2ljuUTi20%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5", "soundPageUrl": "https://www.tiktok.com/music/originalljud-admiring-beauty-7634880283891796758", "coOccurringHashtags": [ "#gym", "#gymtok" ], "topBreakoutVideos": [ { "videoId": "7693657773736807712", "creator": "hrms_nova", "views": 6500000, "url": "https://www.tiktok.com/@hrms_nova/video/7693657773736807712" } ] } ``` #### Output Field Dictionary | Output Field | Type | Description | | :--- | :--- | :--- | | `musicId / soundPageUrl` | `string` | 19-digit TikTok music ID and canonical `https://www.tiktok.com/music/...` URL. | | `musicTitle / musicArtist / musicAlbum` | `string \| null` | Track title, artist/creator name, and album metadata. | | `discoveryKeyword` | `string` | Seed niche keyword (or `direct_sound_id`) that surfaced the track. | | `velocityScore / trendStage` | `int / str` | `0`–`100` composite velocity score and lifecycle stage classification. | | `postsLast24HoursPct / postsLast7DaysPct` | `number` | Percentage of sampled sound-feed videos uploaded in the past 24h and 7d. | | `sampleVideosAnalyzed / uniqueCreatorsInSample` | `integer` | Feed sample depth and distinct creator breadth. | | `avgViewsSample / avgEngagementRatePct` | `int / float` | Mean views and engagement rate across videos using the sound. | | `isOriginalSound / durationSec` | `bool / int` | Whether the track is user-uploaded original audio vs. commercial music, plus clip length. | | `audioPreviewUrl / coverUrl` | `string \| null` | Playable CDN MP3 preview stream and cover artwork. | | `coOccurringHashtags / topBreakoutVideos` | `array` | Top paired hashtags and highest-performing sample video URLs/stats. | ### Notes, tips, and exceptions - **Commercial account music restrictions:** Corporate brand accounts on TikTok cannot legally use mainstream record-label songs (`isOriginalSound: false`) in ads without licensing — filter `isOriginalSound == true` or check TikTok Commercial Music Library status before running Spark Ads. - **Why `includeSampleVideos: true` is recommended:** Without inspecting `/api/music/item_list/`, recency ratios (`postsLast24HoursPct`, `postsLast7DaysPct`) cannot be measured. - **Expiring `audioPreviewUrl` tokens:** CDN MP3 preview links include signed timestamps; play or archive them soon after extraction. ### What can you do with data from TikTok Sound & Trend Velocity Radar? TikTok Sound & Trend Velocity Radar powers high-ROI automation, lead generation, and AI agent pipelines. Here are four proven step-by-step recipes: #### 🎸 Record-label A\&R & independent artist breakout scout Sign or playlist independent tracks catching organic UGC velocity days before Spotify Viral 50 charts react. **Recipe:** 1. **Scan genre & mood keywords daily.** Run `keywords: ["indie bedroom pop", "unreleased song", "country demo", "afrobeats"]` with `maxTrends: 30`. 2. **Filter high-acceleration tracks.** Select rows where `postsLast7DaysPct >= 40` and `uniqueCreatorsInSample >= 5` (proving multi-creator organic pickup, not just 1 artist spamming their own song). 3. **Cross-check Google Search crossover.** Verify artist search momentum in **[Google Trends Scraper](https://apify.com/church_of_loujess/google-trends-fast-scraper)**. Deliver daily MP3 + velocity digests straight to A\&R Slack channels. #### 📱 Social media agency daily trend & audio brief Give brand editors 5 rising niche-relevant sounds + visual reference links every morning. **Recipe:** 1. **Run client aesthetic keywords.** Pass `["clean girl aesthetic", "startup office humor", "coffee routine"]`. 2. **Sort by `velocityScore` descending.** Share `soundPageUrl`, `coOccurringHashtags`, and `topBreakoutVideos[0]` in Notion or Slack. Eliminates hours of manual 'doomscrolling for research'. #### 📊 Music-marketing campaign tracker (`soundIds`) Track daily UGC pickup across 10 official artist campaign sounds. **Recipe:** 1. **Pass campaign `soundIds` daily.** Log `avgViewsSample`, `postsLast24HoursPct`, and `topBreakoutVideos` to Google Sheets or Airtable. Spot which seeded influencer video ignited secondary organic creations. #### 🎬 Match background mood audio to spoken UGC scripts Background instrumental tracks at 8% volume boost spoken-video completion rates. **Recipe:** 1. **Find instrumental aesthetic sounds.** Search `["storytime background music", "motivational instrumental"]`. 2. **Pair with outlier spoken hooks.** Combine with **[TikTok Viral Hook & Script Scraper](https://apify.com/church_of_loujess/tiktok-viral-hook-script-scraper)**. Complete creative-production stack in two zero-proxy Actors. ### Want to get other B2B, Social, Financial, or MCP Agent data? Chain this tool with our other **128 MB / 256 MB zero-proxy Apify Scrapers and Live Streamable-HTTP MCP Servers**:
🔌 TikTok Intelligence MCP Server (Claude, ChatGPT, Cursor) 🎣 TikTok Viral Hook & Spoken Script Scraper
🔎 TikTok Search Scraper (Keywords, Hashtags & Music Expansion) 📈 Google Trends Scraper & Breakout Keyword API
🕵️ TikTok Brand Sponsor & Paid Partnership Spy 📧 TikTok Influencer, UGC & Shop Affiliate Email Finder
💬 TikTok Comment Buyer-Intent & Warm Lead Miner 👤 TikTok Profile Scraper (Stats, Bio Emails & Posts)
### 🔌 Using TikTok Sound & Trend Velocity Radar with the Apify API, SDKs & MCP Automate **TikTok Sound & Trend Velocity Radar** programmatically from Python, Node.js/TypeScript, cURL, workflow builders (**n8n, Make, Zapier, Clay, Pipedream**), or **Model Context Protocol (`MCP`)** AI clients. #### Python (`apify-client`) ```python from apify_client import ApifyClient client = ApifyClient("") run = client.actor("church_of_loujess/tiktok-sound-trend-radar").call( run_input={ "keywords": [ "gym motivation", "aesthetic vlog", "dark academia" ], "maxTrends": 20, "includeSampleVideos": True } ) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) ``` #### Node.js / TypeScript (`apify-client`) ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: '' }); const run = await client.actor('church_of_loujess/tiktok-sound-trend-radar').call({ "keywords": [ "gym motivation", "aesthetic vlog", "dark academia" ], "maxTrends": 20, "includeSampleVideos": true }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(`Extracted ${items.length} items:`, items); ``` #### One-Line Synchronous REST API (`cURL` — ideal for n8n, Make & Clay HTTP Columns) ```bash curl -X POST "https://api.apify.com/v2/acts/church_of_loujess~tiktok-sound-trend-radar/run-sync-get-dataset-items?token=" \ -H "Content-Type: application/json" \ -d '{"keywords": ["gym motivation", "aesthetic vlog", "dark academia"], "maxTrends": 20, "includeSampleVideos": true}' ``` #### Claude Desktop, Cursor, Windsurf & OpenAI MCP Configuration ```json { "mcpServers": { "apify-tiktok-sound-trend-radar": { "url": "https://mcp.apify.com/?actors=church_of_loujess/tiktok-sound-trend-radar", "headers": { "Authorization": "Bearer " } } } } ``` ### ❓ Frequently Asked Questions #### How is `velocityScore` (`0–100`) calculated? It combines 24-hour and 7-day upload recency (`postsLast24HoursPct`, `postsLast7DaysPct`), creator diversity (`uniqueCreatorsInSample`), and average sample view velocity (`avgViewsSample`) across the sound's active video feed. #### Can I pass a `https://www.tiktok.com/music/...` URL inside `soundIds`? Yes — both bare 19-digit numeric music IDs and full `tiktok.com/music/-` URLs are parsed automatically. #### What do the `trendStage` labels mean? `breakout_surge` (high concentration of uploads in the past 24h–7d), `rising_momentum` (steady recent creator adoption), and `established_hit` (high total view baseline with broader historical spread). #### How do I distinguish original creator audio from copyrighted songs? Check `isOriginalSound`: `true` indicates user-uploaded original sound/voiceover audio; `false` indicates catalog music. #### Does `includeSampleVideos` cost extra dataset items? No! Sample breakout videos (`topBreakoutVideos[]`) are nested inside the parent sound's dataset item — 1 sound trend report = 1 dataset item. #### Do I need proxies or a TikTok login? No. Everything runs inside `256 MB` RAM with zero proxy fees. #### Is it legal to extract public data with TikTok Sound & Trend Velocity Radar? TikTok Sound & Trend Velocity Radar only accesses **publicly available web pages, feeds, and registries** that require no private account login or authentication bypass. Keep in mind that extracted contact fields (such as public business emails, names, or usernames) can still qualify as personal data under frameworks like the [GDPR](https://en.wikipedia.org/wiki/General_Data_Protection_Regulation) or CCPA depending on jurisdiction. Always ensure you have a lawful basis (such as legitimate B2B interest) and consult Apify's guide on [the legality of web scraping](https://blog.apify.com/is-web-scraping-legal/). #### Can I integrate TikTok Sound & Trend Velocity Radar with Clay, n8n, Make, Zapier, or Google Sheets? Yes. Every run outputs clean, flat-friendly fields alongside nested detail objects and integrates natively with **Clay, n8n, Make, Zapier, Slack, HubSpot, Airtable, Google Sheets, Airbyte, LangChain, and CrewAI** via [Apify Integrations](https://apify.com/integrations). You can also attach [webhooks](https://docs.apify.com/integrations/webhooks) to trigger downstream workflows automatically the instant a run succeeds. #### Can I call TikTok Sound & Trend Velocity Radar programmatically via the Apify API? Yes. Use the official `apify-client` [Python package](https://apify.com/church_of_loujess/tiktok-sound-trend-radar/api/python) or [Node.js NPM package](https://apify.com/church_of_loujess/tiktok-sound-trend-radar/api/javascript), or call the synchronous `/run-sync-get-dataset-items` REST endpoint directly. Full specifications are in the [Apify API v2 reference](https://docs.apify.com/api/v2). #### TikTok Sound & Trend Velocity Radar not working or need a custom feature? We actively maintain and monitor all 26 Actors and MCP Servers in our portfolio. If you encounter an edge case, unexpected output, or want to request a new field, please open a ticket on the Actor's [Issues tab](https://apify.com/church_of_loujess/tiktok-sound-trend-radar/issues/open) with your Run ID so we can resolve it rapidly. # Actor input Schema ## `keywords` (type: `array`): Niches or genres to scan for rising TikTok audio tracks and breakout sounds (e.g. 'gym motivation', 'aesthetic vlog', 'indie pop'). ## `soundIds` (type: `array`): Optional specific TikTok sound IDs or music URLs to analyze velocity for. ## `maxTrends` (type: `integer`): Maximum number of analyzed trending sounds to output. ## `includeSampleVideos` (type: `boolean`): Fetch the sound's feed (/api/music/item_list/) to compute 7-day upload velocity and include top viral example videos. ## Actor input object example ```json { "keywords": [ "gym motivation", "aesthetic vlog" ], "soundIds": [], "maxTrends": 15, "includeSampleVideos": true } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "keywords": [ "gym motivation", "aesthetic vlog" ] }; // Run the Actor and wait for it to finish const run = await client.actor("church_of_loujess/tiktok-sound-trend-radar").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "keywords": [ "gym motivation", "aesthetic vlog", ] } # Run the Actor and wait for it to finish run = client.actor("church_of_loujess/tiktok-sound-trend-radar").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "keywords": [ "gym motivation", "aesthetic vlog" ] }' | apify call church_of_loujess/tiktok-sound-trend-radar --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,church_of_loujess/tiktok-sound-trend-radar" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/g3ysxCAaMqMXd0K65/builds/T1DMZSY96ZceGt7cI/openapi.json