# TikTok Trending Videos Scraper (`khadinakbar/tiktok-trending-videos-scraper`) Actor Scrape trending TikTok videos from the Explore feed โ€” views, likes, comments, shares, author, music, hashtags & no-watermark video URLs. Filter by country. No login. MCP-ready. - **URL**: https://apify.com/khadinakbar/tiktok-trending-videos-scraper.md - **Developed by:** [Khadin Akbar](https://apify.com/khadinakbar) (community) - **Categories:** Social media, Videos, MCP servers - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 trending video extracteds This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## ๐ŸŽฌ TikTok Trending Videos Scraper Scrape **trending TikTok videos** straight from TikTok's **Explore** feed โ€” the curated mix of viral videos TikTok surfaces to everyone, plus full engagement stats, creator data, music, hashtags, and a **direct no-watermark video URL** for every result. No login, no cookies, no TikTok API key. Point it at a country, set how many videos you want, and get a clean structured dataset of what's trending right now. ### What you get โ€” one row per trending video | Field | Description | |---|---| | `rank` | Position in the trending feed (1 = surfaced first) | | `videoUrl` | Canonical `tiktok.com/@handle/video/id` link | | `videoPlayUrl` | **Direct no-watermark MP4 URL** (short-lived, signed) | | `description` | Caption text with inline hashtags | | `authorHandle` / `authorName` | Creator @username and display name | | `authorVerified` / `authorFollowers` | Verified badge + follower count | | `playCount` | Views | | `likeCount` / `commentCount` / `shareCount` / `saveCount` | Full engagement | | `engagementRate` | (likes + comments + shares) รท views | | `musicTitle` / `musicAuthor` / `musicIsOriginal` | Sound used | | `hashtags` | Array of hashtag names | | `coverUrl` | Thumbnail image | | `createTime` | Publish date (ISO 8601) | | `durationSec` | Length in seconds | | `region` / `feed` / `scrapedAt` / `sourceUrl` | Run metadata | ### When to use this - **Trend discovery** โ€” see what's going viral in any country, today. - **Content planning** โ€” find formats, hooks, and sounds that are spiking. - **Sound research** โ€” grab the trending audio behind viral videos. - **Creator scouting** โ€” spot accounts breaking out in the trending feed. - **Competitor & niche research** โ€” monitor what's winning attention in a market. - **AI agents / pipelines** โ€” feed concise structured trending data to an LLM. ### When NOT to use this (pick the right actor) - Want **one creator's** videos? โ†’ `khadinakbar/tiktok-profile-scraper` - Want **TikTok ad creatives** (Top Ads / Creative Center)? โ†’ `khadinakbar/tiktok-ads-scraper` - Want **trending hashtags** with rank movement? โ†’ `khadinakbar/tiktok-trending-hashtags-scraper` - Want **comments** on videos? โ†’ `khadinakbar/tiktok-video-comments-scraper` This actor is specifically the **organic trending video feed**. ### Pricing โ€” Pay Per Event | Event | Price | |---|---| | Actor start | $0.00005 per GB RAM | | Trending video extracted | **$0.005** per video | A typical run of 50 trending videos costs about **$0.25**. You're only charged for videos actually returned โ€” the cost cap is printed in the run log before any charge fires, and the actor never charges past your `maxResults`. ### Quick start #### In Apify Console 1. Pick a **Feed** (`Explore` for curated trending โ€” recommended). 2. Optionally set a **Country / Region** (e.g. `US`, `JP`). 3. Set **Max Videos** (default 50). 4. Keep the default **Residential** proxy. Click **Start**. #### Via API (Node.js) ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_TOKEN' }); const run = await client.actor('khadinakbar/tiktok-trending-videos-scraper').call({ feed: 'explore', region: 'US', maxResults: 50, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items[0].videoUrl, items[0].playCount); ```` #### Via API (Python) ```python from apify_client import ApifyClient client = ApifyClient("YOUR_TOKEN") run = client.actor("khadinakbar/tiktok-trending-videos-scraper").call(run_input={ "feed": "explore", "region": "US", "maxResults": 50, }) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item["videoUrl"], item["playCount"]) ``` #### Via MCP (Claude, ChatGPT, agents) This actor is MCP-ready. Connect to `https://mcp.apify.com?tools=khadinakbar/tiktok-trending-videos-scraper` and ask: *"Get the top 20 trending TikTok videos in Japan right now."* Inputs are narrow and the output is flat structured JSON built for LLM consumption. ### Input reference | Field | Type | Default | Notes | |---|---|---|---| | `feed` | enum | `explore` | `explore` (curated trending) or `foryou` (personalized) | | `region` | enum | `""` (auto) | ISO country code; routes through a residential proxy in that country | | `maxResults` | integer | `50` | 1โ€“200 | | `proxyConfiguration` | object | Residential | Residential strongly recommended โ€” datacenter IPs get blocked | ### Reliability notes - **Residential proxy is required.** TikTok.com blocks datacenter IPs; the actor defaults to Apify Residential. If you see no data, confirm residential proxy is enabled. - **Explore vs For You.** `explore` is the curated trending feed and is reproducible run-to-run. `foryou` is personalized and session-randomized โ€” use it for sampling, not for a stable trending list. - **Honest failures.** If TikTok blocks the run entirely, it is marked **FAILED** with a clear message โ€” the actor never reports success with an empty dataset. - **Pagination.** The feed loads ~8 videos per scroll; larger `maxResults` takes proportionally longer. ### FAQ **Do I need a TikTok account or API key?** No. **Are the video URLs watermark-free?** Yes โ€” `videoPlayUrl` is the direct stream. It's signed and short-lived, so download promptly. **Can I filter by category (Comedy, Sports, etc.)?** Not in v1 โ€” results span all categories in the Explore feed. Country filtering is supported via `region`. **Why might a run return fewer than `maxResults`?** The Explore feed has a finite trending set per region; the actor stops when the feed is exhausted. **Is the For You feed truly "trending"?** For You is *personalized recommendations*, not a curated trending list. For reproducible trending data, use `explore`. ### Legal & compliance This actor collects **publicly available** data from TikTok's Explore feed for research and analytics. It does not log in, bypass authentication, or access private content. You are responsible for using the data in compliance with TikTok's Terms of Service, applicable laws (including GDPR/CCPA where relevant), and any platform restrictions. Do not use scraped personal data for unlawful purposes. Video and audio content remains the property of its respective creators and rights holders. *** Built by [khadinakbar](https://apify.com/khadinakbar) ยท Part of the TikTok scraping suite: [Trending Hashtags](https://apify.com/khadinakbar/tiktok-trending-hashtags-scraper) ยท [Ads](https://apify.com/khadinakbar/tiktok-ads-scraper) ยท [Profile](https://apify.com/khadinakbar/tiktok-profile-scraper) ยท [Video Comments](https://apify.com/khadinakbar/tiktok-video-comments-scraper) # Actor input Schema ## `feed` (type: `string`): Which TikTok feed to scrape. 'explore' returns TikTok's curated Explore trending videos (the default โ€” reproducible, the same trending mix every viewer sees). 'foryou' returns the personalized For You feed, which is session-randomized and less reproducible run-to-run. This is NOT a single profile's videos โ€” for that use the tiktok-profile-scraper actor. ## `region` (type: `string`): Two-letter ISO country code to localize trending results (e.g. 'US', 'GB', 'JP'). Routes the request through a residential proxy in that country so TikTok returns that region's trending videos. Leave empty to use the proxy's default IP. This is a country, not a city or language. ## `maxResults` (type: `integer`): Maximum number of trending videos to return (1โ€“200). The actor scrolls the feed to paginate (~8 videos load per scroll), so larger values take longer. Use 20โ€“50 for a quick trending snapshot, 100โ€“200 for a full report. Each returned video is billed at $0.005. ## `proxyConfiguration` (type: `object`): Proxy settings. Apify Residential proxies are strongly recommended (and the default) โ€” tiktok.com blocks datacenter IPs, so non-residential runs usually return no data. Set the country here OR via the Region field above to localize trending results. ## Actor input object example ```json { "feed": "explore", "region": "", "maxResults": 50, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `trendingVideos` (type: `string`): Dataset of trending TikTok video records. Each item: rank, videoId, videoUrl, description, createTime, durationSec, authorHandle, authorName, authorFollowers, playCount, likeCount, commentCount, shareCount, saveCount, engagementRate, musicTitle, hashtags, coverUrl, videoPlayUrl, isAd, region, feed, scrapedAt, sourceUrl. # 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 = { "feed": "explore", "region": "", "maxResults": 50, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("khadinakbar/tiktok-trending-videos-scraper").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 = { "feed": "explore", "region": "", "maxResults": 50, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("khadinakbar/tiktok-trending-videos-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "feed": "explore", "region": "", "maxResults": 50, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call khadinakbar/tiktok-trending-videos-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=khadinakbar/tiktok-trending-videos-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "TikTok Trending Videos Scraper", "description": "Scrape trending TikTok videos from the Explore feed โ€” views, likes, comments, shares, author, music, hashtags & no-watermark video URLs. Filter by country. No login. MCP-ready.", "version": "1.0", "x-build-id": "k3L4jNmUNWYYve9TG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~tiktok-trending-videos-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-tiktok-trending-videos-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/khadinakbar~tiktok-trending-videos-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-tiktok-trending-videos-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/khadinakbar~tiktok-trending-videos-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-tiktok-trending-videos-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "feed": { "title": "Feed", "enum": [ "explore", "foryou" ], "type": "string", "description": "Which TikTok feed to scrape. 'explore' returns TikTok's curated Explore trending videos (the default โ€” reproducible, the same trending mix every viewer sees). 'foryou' returns the personalized For You feed, which is session-randomized and less reproducible run-to-run. This is NOT a single profile's videos โ€” for that use the tiktok-profile-scraper actor.", "default": "explore" }, "region": { "title": "Country / Region", "enum": [ "", "US", "GB", "IN", "BR", "MX", "ID", "JP", "KR", "DE", "FR", "TR", "RU", "ES", "IT", "CA", "AU", "AR", "CO", "TH", "VN", "NL", "PL", "SA", "AE", "SG", "PH", "MY", "NG", "ZA", "CL", "PE", "TW", "PK", "BD", "EG", "AT", "BE", "BG", "BY", "CZ", "DK", "FI", "GR", "HU", "IE", "IL", "IQ", "IS", "KH", "KW", "LB", "LT", "LV", "MA", "MM", "NO", "NZ", "OM", "PT", "QA", "RO", "SK", "SE", "CH", "UA", "UZ" ], "type": "string", "description": "Two-letter ISO country code to localize trending results (e.g. 'US', 'GB', 'JP'). Routes the request through a residential proxy in that country so TikTok returns that region's trending videos. Leave empty to use the proxy's default IP. This is a country, not a city or language.", "default": "" }, "maxResults": { "title": "Max Videos", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum number of trending videos to return (1โ€“200). The actor scrolls the feed to paginate (~8 videos load per scroll), so larger values take longer. Use 20โ€“50 for a quick trending snapshot, 100โ€“200 for a full report. Each returned video is billed at $0.005.", "default": 50 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Apify Residential proxies are strongly recommended (and the default) โ€” tiktok.com blocks datacenter IPs, so non-residential runs usually return no data. Set the country here OR via the Region field above to localize trending results.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```