# TikTok Trending Product Videos (`burbn/tiktok-trending-product-videos`) Actor Stop guessing what's viral! Find winning products and trending ads in seconds. Scrape viral TikTok videos with engagement metrics, cover images, and direct links across 24+ countries. No login required. Perfect for dropshippers and marketers! - **URL**: https://apify.com/burbn/tiktok-trending-product-videos.md - **Developed by:** [Kevin](https://apify.com/burbn) (community) - **Categories:** E-commerce, Social media, Videos - **Stats:** 10 total users, 7 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 results 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/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 - Discover Viral TikTok Content **Find the hottest trending videos on TikTok across 24+ countries. Scrape viral video data including titles, cover images, durations, and direct TikTok links. Filter by country, time period, and sort by views, likes, comments, or shares — all without a TikTok account!** ### 📋 Table of Contents - [🚀 Features](#-features) - [🎯 Use Cases](#-use-cases) - [⚡ Quick Start](#-quick-start) - [📊 Input Parameters](#-input-parameters) - [📤 Output Format](#-output-format) - [🎬 Video Data Extracted](#-video-data-extracted) - [📈 Performance & Reliability](#-performance--reliability) - [💡 Best Practices](#-best-practices) - [❓ FAQ](#-faq) - [🔗 Related Actors](#-related-actors) ### 🚀 Features #### 🎬 **Complete Video Intelligence** - ✅ **No Login Required** — Discover trending videos without a TikTok account - ✅ **24+ Countries** — Filter videos by region (US, UK, DE, FR, JP, and many more) - ✅ **Time Period Filter** — Get trending videos from the last 7 or 30 days - ✅ **Multiple Sort Options** — Sort by views (hot), likes, comments, or shares - ✅ **Cover Images** — High-quality video thumbnail/cover images - ✅ **Real-Time Data** — Access the latest trending video data from TikTok #### 📊 **Comprehensive Data** - ✅ **Video Title** — Full title/caption of each trending video - ✅ **Duration** — Video length in seconds - ✅ **Cover Image URL** — CDN-hosted thumbnail image - ✅ **Direct TikTok Link** — Link to watch the video on TikTok - ✅ **Country & Region** — Geographic location associated with the video - ✅ **Video IDs** — Unique identifiers for each video ### 🎯 Use Cases | Use Case | Description | Benefits | |----------|-------------|----------| | 📈 **Trend Analysis** | Monitor viral video trends across regions | Stay ahead of content trends | | 🎥 **Content Research** | Analyze what types of content go viral | Inform your content strategy | | 🔍 **Competitor Research** | See what's trending in your niche | Benchmark against top-performing content | | 🛍️ **Product Discovery** | Find trending product-related videos | Identify viral products for e-commerce | | 📊 **Market Research** | Track video trends across countries | Understand regional content preferences | | 🎯 **Campaign Inspiration** | Find trending content formats and styles | Create campaigns that resonate | ### ⚡ Quick Start #### 1️⃣ **Hottest Videos in the US (Last 7 Days)** ```json { "country_code": "US", "period": "7", "order_by": "vv", "maxResults": 100 } ```` #### 2️⃣ **Most Liked Videos (Last 30 Days)** ```json { "country_code": "US", "period": "30", "order_by": "like", "maxResults": 50 } ``` #### 3️⃣ **Most Commented Videos in UK** ```json { "country_code": "GB", "period": "7", "order_by": "comment", "maxResults": 100 } ``` #### 4️⃣ **Most Shared Videos (All Countries)** ```json { "country_code": "", "period": "7", "order_by": "repost", "maxResults": 200 } ``` ### 📊 Input Parameters #### Configuration Options | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `country_code` | String | `""` | Country ISO code (e.g., US, GB, DE, FR, JP). Empty for all countries. | | `period` | String | `"7"` | Time period: `7` (Last 7 days) or `30` (Last 30 days) | | `order_by` | String | `"vv"` | Sort by: `vv` (Hot/Views), `like` (Likes), `comment` (Comments), `repost` (Shares) | | `page` | Integer | `1` | Start extraction from this page | | `maxResults` | Integer | `20` | Maximum number of videos to retrieve (0 for all) | | `limit` | Integer | `20` | Results per page per request (Max 20) | #### 🌍 Supported Countries Australia, Brazil, Canada, Egypt, France, Germany, Indonesia, Israel, Italy, Japan, Malaysia, Philippines, Russia, Saudi Arabia, Singapore, South Korea, Spain, Taiwan, Thailand, Turkey, United Arab Emirates, United Kingdom, United States, Vietnam ### 📤 Output Format #### 🎬 **Video Data Structure** ```json { "source": "tiktok_trending_videos", "id": "7603078509434572063", "item_id": "7603078509434572063", "title": "order accordingly. they're here for a limited time.", "cover": "https://p16-sign-va.tiktokcdn.com/...", "duration": 15, "country_code": "US", "region": "United States", "item_url": "https://www.tiktok.com/@mnm_pipi/video/7603078509434572063" } ``` ### 🎬 Video Data Extracted #### 🏷️ **Video Info** | Element | Description | Details | |---------|-------------|---------| | **Title** | Video's caption/title | The full text caption shown on TikTok | | **Cover** | Video thumbnail image URL | CDN-hosted cover image | | **Duration** | Video length in seconds | Duration of the video | | **Video ID** | TikTok video identifier | Unique video ID | | **Item ID** | TikTok item identifier | Unique item reference | #### 📍 **Location Data** | Element | Description | Details | |---------|-------------|---------| | **Country Code** | ISO 2-letter country code | e.g., US, GB, DE | | **Region** | Full country/region name | e.g., United States, United Kingdom | #### 🔗 **Links** | Element | Description | Details | |---------|-------------|---------| | **Item URL** | Direct link to TikTok video | Watch the video on TikTok | ### 📈 Performance & Reliability #### 🔄 **Reliability Features** - ✅ **Auto-Retry & Backoff** — Handles temporary connection hiccups gracefully - ✅ **Dynamic Pagination** — Seamlessly loops through all pages of results - ✅ **Batch Processing** — Efficiently pushes data in batches of 10 items - ✅ **Fail-Safes** — Early exits if maximum results limit is reached ### 💡 Best Practices #### ✅ **Recommended Usage** 1. **Start Small** — Use `maxResults: 20` first to verify your filters work correctly before running large scrapes. 2. **Use Time Periods Wisely** — 7-day trends show current viral content; 30-day trends show sustained popularity. 3. **Sort by Different Metrics** — Views show reach, likes show engagement, comments show discussion, shares show virality. 4. **Compare Across Countries** — Video trends vary significantly by region; what's viral in the US may differ from UK/EU. 5. **Download Cover Images Promptly** — CDN-hosted image URLs may expire; download them if needed for your workflow. 6. **Monitor Regularly** — Set up scheduled runs to track how trends evolve over time. #### ⚠️ **Important Notes** - The API uses standard ISO 2-letter country codes (e.g., `US`, `GB`, `DE`). - Cover image URLs are CDN-hosted and may expire after some time; download them promptly if needed. - Maximum results per page is 20 (API limit). - Total available videos per country is typically up to 500. ### ❓ FAQ #### **Q: Do I need a TikTok account?** **A:** No, this tool uses specialized endpoints and does not require login, cookies, or account access. #### **Q: What does `order_by` control?** **A:** `vv` sorts by views (hottest videos), `like` sorts by likes, `comment` sorts by comments, and `repost` sorts by shares. #### **Q: What are the available time periods?** **A:** `7` returns trending videos from the last 7 days, and `30` returns trending videos from the last 30 days. #### **Q: How many videos can I scrape?** **A:** The API provides up to 500 trending videos per country. Use `maxResults: 0` to scrape all available videos. #### **Q: How often is the data updated?** **A:** TikTok's trending video data is updated regularly with the latest viral content. *** ### 🔗 Related Actors | Actor | Description | |-------|-------------| | [🌟 TikTok Trending Creators](https://apify.com/burbn/tiktok-trending-creators) | Discover trending TikTok creators and influencers with follower counts and engagement data | | [📊 TikTok Top Ads Spy](https://apify.com/burbn/tiktok-top-ads-spy) | Scrape top-performing TikTok ads with video URLs, CTR, likes, and creative data | | [📦 TikTok Trending Products](https://apify.com/burbn/tiktok-trending-products-scraper) | Discover viral products and profitable niches on TikTok | *** ### 🏷️ **Keywords & Tags** `tiktok trending videos`, `tiktok videos scraper`, `tiktok viral videos`, `tiktok video scraper`, `tiktok trend scraper`, `tiktok video data`, `tiktok video extractor`, `tiktok viral content`, `tiktok video analytics`, `tiktok video trends`, `tiktok content scraper`, `tiktok video cover`, `tiktok video title`, `tiktok video duration`, `tiktok video link`, `tiktok trending content`, `tiktok hot videos`, `tiktok popular videos`, `tiktok most liked videos`, `tiktok most shared videos`, `tiktok most commented videos`, `tiktok video research`, `tiktok content research`, `tiktok trend analysis`, `tiktok video intelligence`, `tiktok scraper`, `apify tiktok`, `tiktok api scraper`, `tiktok data extraction`, `social media scraper`, `video trend tool`, `content discovery tool`, `tiktok video discovery`, `tiktok content analytics` *** ### 🎁 Get $5 Free Apify Credits New to Apify? [Sign up using this link](https://apify.com?fpr=free-credits) and get **$5 free credits** to start scraping TikTok trending videos right away! No credit card required. **⭐ If this actor helps your workflow, please give it a star!** *** # Actor input Schema ## `country_code` (type: `string`): Select a country to filter trending videos by region. Leave empty for all countries. ## `period` (type: `string`): Select time period for trending videos. ## `order_by` (type: `string`): Sort trending videos by a specific metric. ## `page` (type: `integer`): The page number to start scraping from. Default: 1. ## `maxResults` (type: `integer`): Maximum number of videos to scrape. Set to 0 for unlimited. Default: 20. ## `limit` (type: `integer`): Number of videos per API request. Max 20. Default: 20. ## Actor input object example ```json { "country_code": "US", "period": "7", "order_by": "vv", "page": 1, "maxResults": 20, "limit": 20 } ``` # Actor output Schema ## `overview` (type: `string`): Open the dataset view with an overview of scraped TikTok trending videos including key metrics. ## `detailed` (type: `string`): Open the dataset view with detailed data for each scraped TikTok trending video. # 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 = { "country_code": "US", "period": "7", "order_by": "vv", "page": 1, "maxResults": 20, "limit": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("burbn/tiktok-trending-product-videos").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 = { "country_code": "US", "period": "7", "order_by": "vv", "page": 1, "maxResults": 20, "limit": 20, } # Run the Actor and wait for it to finish run = client.actor("burbn/tiktok-trending-product-videos").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 '{ "country_code": "US", "period": "7", "order_by": "vv", "page": 1, "maxResults": 20, "limit": 20 }' | apify call burbn/tiktok-trending-product-videos --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=burbn/tiktok-trending-product-videos", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "TikTok Trending Product Videos", "description": "Stop guessing what's viral! Find winning products and trending ads in seconds. Scrape viral TikTok videos with engagement metrics, cover images, and direct links across 24+ countries. No login required. Perfect for dropshippers and marketers!", "version": "1.0", "x-build-id": "CkEAW4FYcC84Pyxly" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/burbn~tiktok-trending-product-videos/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-burbn-tiktok-trending-product-videos", "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/burbn~tiktok-trending-product-videos/runs": { "post": { "operationId": "runs-sync-burbn-tiktok-trending-product-videos", "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/burbn~tiktok-trending-product-videos/run-sync": { "post": { "operationId": "run-sync-burbn-tiktok-trending-product-videos", "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": { "country_code": { "title": "🌍 Country", "enum": [ "", "AU", "BR", "CA", "EG", "FR", "DE", "ID", "IL", "IT", "JP", "MY", "PH", "RU", "SA", "SG", "KR", "ES", "TW", "TH", "TR", "AE", "GB", "US", "VN" ], "type": "string", "description": "Select a country to filter trending videos by region. Leave empty for all countries.", "default": "" }, "period": { "title": "📅 Time Period", "enum": [ "7", "30" ], "type": "string", "description": "Select time period for trending videos.", "default": "7" }, "order_by": { "title": "📈 Sort By", "enum": [ "vv", "like", "comment", "repost" ], "type": "string", "description": "Sort trending videos by a specific metric.", "default": "vv" }, "page": { "title": "📄 Start Page Number", "minimum": 1, "type": "integer", "description": "The page number to start scraping from. Default: 1.", "default": 1 }, "maxResults": { "title": "🎯 Max Results", "minimum": 0, "type": "integer", "description": "Maximum number of videos to scrape. Set to 0 for unlimited. Default: 20.", "default": 20 }, "limit": { "title": "📐 Results Per Page", "minimum": 1, "maximum": 20, "type": "integer", "description": "Number of videos per API request. Max 20. Default: 20.", "default": 20 } } }, "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 } } } } } } } } } } ```