# TikTok Trending Products (`burbn/tiktok-trending-products-scraper`) Actor Find your next winner! Discover viral products and profitable niches on TikTok. Scrape trending categories, winning ads, CTR, CVR, and CPA data from TikTok Creative Center. No login required! - **URL**: https://apify.com/burbn/tiktok-trending-products-scraper.md - **Developed by:** [Kevin](https://apify.com/burbn) (community) - **Categories:** E-commerce, Social media, Automation - **Stats:** 19 total users, 9 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 Products Scraper **Discover the hottest trending product categories on TikTok ads across 50+ countries. Analyze performance metrics like CTR, CVR, CPA, Impressions, and engagement data. Find winning product niches for e-commerce, dropshipping, and ad campaigns — 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) - [📦 Product Data Extracted](#-product-data-extracted) - [📈 Performance & Reliability](#-performance--reliability) - [💡 Best Practices](#-best-practices) - [❓ FAQ](#-faq) - [🔗 Related Actors](#-related-actors) ### 🚀 Features #### 📦 **Complete Product Intelligence** - ✅ **No Login Required** — Discover trending products without a TikTok account - ✅ **50+ Countries** — Filter trending products by region (US, UK, DE, FR, JP, and many more) - ✅ **3-Level Category Hierarchy** — Full breakdown from top-level category to specific product type - ✅ **Keyword Search** — Find specific product categories by keyword - ✅ **Real-Time Data** — Access the latest trending product data from TikTok's Creative Center #### 📊 **Comprehensive Metrics** - ✅ **Popularity Tracking** — Number of ad posts and popularity change percentage - ✅ **CTR & CVR** — Click-Through Rate and Conversion Rate for every product category - ✅ **CPA & Cost** — Cost Per Action and total ad spending data - ✅ **Engagement Data** — Likes, Shares, Comments, and Impressions - ✅ **View Rates** — 6-second view rate for ad performance analysis - ✅ **Cover Images** — Product cover image URLs when available ### 🎯 Use Cases | Use Case | Description | Benefits | |----------|-------------|----------| | 🛍️ **Dropshipping Research** | Find products trending in TikTok ads | Discover winning products before they saturate | | 📈 **E-commerce Strategy** | Analyze product category performance | Invest in high-CVR, low-CPA product niches | | 🔍 **Market Intelligence** | Track product trends across countries | Understand regional demand before launching | | 🎯 **Ad Campaign Planning** | Identify high-performing product niches | Lower your CPA by targeting proven categories | | 📊 **Competitor Analysis** | See which product categories have the most ad activity | Benchmark your niche against the market | | 📉 **Trend Detection** | Monitor `post_change` for rising/declining categories | Jump on trends early, exit declining ones | ### ⚡ Quick Start #### 1️⃣ **Top Trending Products (US, Last 7 Days)** ```json { "period_type": "last", "last": "7", "country_code": "US", "order_by": "post", "maxResults": 100 } ```` #### 2️⃣ **Find High-Converting Product Niches** ```json { "period_type": "last", "last": "30", "country_code": "US", "order_by": "cvr", "order_type": "desc", "maxResults": 50 } ``` #### 3️⃣ **Search for Specific Products** ```json { "period_type": "last", "last": "7", "country_code": "GB", "keyword": "skincare", "order_by": "ctr", "maxResults": 200 } ``` #### 4️⃣ **Cheapest CPA Products This Month** ```json { "period_type": "last", "last": "30", "country_code": "US", "order_by": "cpa", "order_type": "asc", "maxResults": 100 } ``` ### 📊 Input Parameters #### Configuration Options | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `period_type` | String | `"last"` | Time period type: `last` (predefined range), `week`, or `month` | | `last` | String | `"7"` | Time range for 'last' period: `1` (Yesterday), `7` (7 days), `30` (30 days) | | `week` | String | `""` | Specific week start date in `YYYY-MM-DD` format (when period\_type is "week") | | `month` | String | `""` | Specific month in `YYYY-MM` format (when period\_type is "month") | | `country_code` | String | `"US"` | Country ISO code (e.g., US, GB, DE, FR, JP) | | `ecom_type` | String | `"l3"` | Product level: `l3` (detailed product) or `l2` (broader subcategory) | | `order_by` | String | `"post"` | Sort by metric (post, ctr, cvr, cpa, cost, like, share, comment, impression, play\_six\_rate) | | `order_type` | String | `"desc"` | Sort direction: `desc` (highest first) or `asc` (lowest first) | | `first_ecom_category_id` | String | `""` | Comma-separated category IDs to filter (e.g., "605196,602284") | | `keyword` | String | `""` | Search keyword to filter products | | `page` | Integer | `1` | Start extraction from this page | | `maxResults` | Integer | `100` | Maximum number of products to retrieve (0 for all) | | `limit` | Integer | `20` | Results per page per request (Max 20) | ### 📤 Output Format #### 📦 **Product Data Structure** ```json { "source": "tiktok_trending_products", "url_title": "Baby-Walkers", "ecom_type": "l3", "first_category_id": "602284", "first_category": "Baby & Maternity", "second_category_id": "878216", "second_category": "Baby Furniture", "third_category_id": "891016", "third_category": "Baby Walkers", "cover_url": "https://p19-cc-sign-sg.tiktokcdn.com/...", "post": 56, "post_change": 10, "impression": 14600, "cost": 266, "ctr": 6.98, "cvr": 7.95, "cpa": 7.46, "like": 37, "share": 3, "comment": 0, "play_six_rate": 14.95 } ``` ### 📦 Product Data Extracted #### 🏷️ **Category & Product Info** | Element | Description | Details | |---------|-------------|---------| | **Product Title** | URL-friendly product category name | e.g., "Baby-Walkers", "Bath-Toys" | | **Category Hierarchy** | 3-level breakdown of product classification | Top category → Subcategory → Product type | | **Category IDs** | Numeric IDs for each category level | Useful for filtering and cross-referencing | | **Cover Image** | Product cover image URL | Available for some product categories | #### 📈 **Performance & Metric Data** | Metric | Description | Details | |--------|-------------|---------| | **Post (Popularity)** | Number of active ad posts in the category | Higher = more advertisers competing | | **Post Change** | Percentage change in popularity | Positive = growing trend, negative = declining | | **CTR** | Click-Through Rate (%) | How compelling the product ads are | | **CVR** | Conversion Rate (%) | How well clicks convert to purchases | | **CPA** | Cost Per Action | Average cost to acquire a customer | | **Cost** | Total ad spending in the category | Higher cost = larger market | | **Impressions** | Total ad views | Indicates market reach | | **Likes / Shares / Comments** | Engagement metrics | Measures audience interest | | **6s View Rate** | Percentage of viewers watching 6+ seconds | Indicates ad hook effectiveness | ### 📈 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. **Sort by CVR for Winners** — Products with high CVR indicate strong purchase intent — great for dropshipping. 3. **Watch the `post_change`** — Positive values = growing trends (get in early), Negative values = declining (avoid or exit). 4. **Compare CPA & CVR Together** — Low CPA + High CVR = the sweet spot for profitable product niches. 5. **Use Country-Specific Data** — Regional trends differ significantly; US trends don't always apply to UK/EU. 6. **Filter by Category** — Use `first_ecom_category_id` to focus on specific verticals and reduce noise. #### ⚠️ **Important Notes** - The API uses standard ISO 2-letter country codes (e.g., `US`, `GB`, `DE`). - Metrics like CTR, CVR, and CPA are estimated values from TikTok's Creative Center data. - Cover image URLs are CDN-hosted and may expire after some time; download them promptly if needed. - When using `period_type: "week"`, the date should be a Monday (week start) in `YYYY-MM-DD` format. ### ❓ 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's the difference between `l2` and `l3` ecom\_type?** **A:** `l3` (Product) gives you the most detailed product categories (e.g., "Baby Walkers"), while `l2` (Subcategory) gives broader categories (e.g., "Baby Furniture"). Use `l3` for specific product research and `l2` for market overview. #### **Q: How do I interpret `post_change`?** **A:** It shows the percentage change in the number of ad posts. A value of `10` means 10% more ads compared to the previous period. Negative values indicate declining interest. #### **Q: Can I filter multiple categories at once?** **A:** Yes, use comma-separated category IDs in the `first_ecom_category_id` field (e.g., `"605190,602264"` for Automotive & Baby categories). #### **Q: How often is the data updated?** **A:** TikTok's Creative Center updates trending product data regularly. Using `period_type: "last"` with `last: "1"` (Yesterday) gives you the most recent data. *** ### 🔗 Related Actors | Actor | Description | |-------|-------------| | [📊 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 | *** ### 🏷️ **Keywords & Tags** `tiktok trending products`, `tiktok products scraper`, `tiktok product research`, `tiktok dropshipping`, `tiktok ecommerce`, `tiktok ads products`, `tiktok product categories`, `tiktok winning products`, `tiktok product trends`, `tiktok creative center`, `tiktok ads scraper`, `tiktok product spy`, `tiktok product analysis`, `tiktok product metrics`, `tiktok ctr products`, `tiktok cvr products`, `tiktok cpa products`, `tiktok product data`, `tiktok product extractor`, `tiktok product tracker`, `tiktok market research`, `tiktok niche finder`, `tiktok product intelligence`, `tiktok ads research`, `tiktok ads analysis`, `tiktok competitor analysis`, `tiktok product monitoring`, `tiktok trend analysis`, `tiktok marketing tool`, `tiktok social media tool`, `tiktok data extraction`, `tiktok scraper`, `apify tiktok`, `tiktok api scraper`, `tiktok product finder`, `dropshipping research tool`, `ecommerce product research`, `winning product finder`, `tiktok ads data`, `tiktok product performance` *** ### 🎁 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 products right away! No credit card required. **⭐ If this actor helps your workflow, please give it a star!** *** # Actor input Schema ## `period_type` (type: `string`): Select how to define the time period. 'Last' uses predefined ranges (1/7/30 days), 'Week' uses a specific week date, 'Month' uses a specific month. ## `last` (type: `string`): When period\_type is 'last', select the time range. 1 = Yesterday, 7 = Last 7 days, 30 = Last 30 days. ## `week` (type: `string`): When period\_type is 'week', enter the week start date in YYYY-MM-DD format (e.g. 2026-01-01). Only used when Period Type is 'Specific Week'. ## `month` (type: `string`): When period\_type is 'month', enter the month in YYYY-MM format (e.g. 2025-01). Only used when Period Type is 'Specific Month'. ## `page` (type: `integer`): The page number to start scraping from. Default: 1. ## `country_code` (type: `string`): Select a country to filter products by region. Leave empty for all countries. ## `ecom_type` (type: `string`): Select the product granularity level. 'Product' shows individual product categories, 'Subcategory' shows broader subcategories. ## `order_by` (type: `string`): Sort products by a specific metric. ## `order_type` (type: `string`): Sort direction - descending (highest first) or ascending (lowest first). ## `first_ecom_category_id` (type: `string`): Select a product category to filter trending products. Leave empty for all categories. ## `keyword` (type: `string`): Search for products by keyword. Leave empty to not filter by keyword. ## `maxResults` (type: `integer`): Maximum number of products to scrape. Set to 0 for unlimited. Default: 100. ## `limit` (type: `integer`): Number of products per API request. Max 20. Default: 20. ## Actor input object example ```json { "period_type": "last", "last": "7", "week": "", "month": "", "page": 1, "country_code": "US", "ecom_type": "l3", "order_by": "post", "order_type": "desc", "first_ecom_category_id": "", "keyword": "", "maxResults": 20, "limit": 20 } ``` # Actor output Schema ## `overview` (type: `string`): Open the dataset view with an overview of scraped TikTok trending products including key metrics. ## `detailed` (type: `string`): Open the dataset view with detailed data for each scraped TikTok trending product. # 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 = { "period_type": "last", "last": "7", "week": "", "month": "", "page": 1, "country_code": "US", "ecom_type": "l3", "order_by": "post", "order_type": "desc", "first_ecom_category_id": "", "keyword": "", "maxResults": 20, "limit": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("burbn/tiktok-trending-products-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 = { "period_type": "last", "last": "7", "week": "", "month": "", "page": 1, "country_code": "US", "ecom_type": "l3", "order_by": "post", "order_type": "desc", "first_ecom_category_id": "", "keyword": "", "maxResults": 20, "limit": 20, } # Run the Actor and wait for it to finish run = client.actor("burbn/tiktok-trending-products-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 '{ "period_type": "last", "last": "7", "week": "", "month": "", "page": 1, "country_code": "US", "ecom_type": "l3", "order_by": "post", "order_type": "desc", "first_ecom_category_id": "", "keyword": "", "maxResults": 20, "limit": 20 }' | apify call burbn/tiktok-trending-products-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=burbn/tiktok-trending-products-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "TikTok Trending Products", "description": "Find your next winner! Discover viral products and profitable niches on TikTok. Scrape trending categories, winning ads, CTR, CVR, and CPA data from TikTok Creative Center. No login required!", "version": "1.0", "x-build-id": "ei3yqJwoDtkcMhGZz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/burbn~tiktok-trending-products-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-burbn-tiktok-trending-products-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/burbn~tiktok-trending-products-scraper/runs": { "post": { "operationId": "runs-sync-burbn-tiktok-trending-products-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/burbn~tiktok-trending-products-scraper/run-sync": { "post": { "operationId": "run-sync-burbn-tiktok-trending-products-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": { "period_type": { "title": "📅 Period Type", "enum": [ "last", "week", "month" ], "type": "string", "description": "Select how to define the time period. 'Last' uses predefined ranges (1/7/30 days), 'Week' uses a specific week date, 'Month' uses a specific month.", "default": "last" }, "last": { "title": "📆 Last N Days", "enum": [ "1", "7", "30" ], "type": "string", "description": "When period_type is 'last', select the time range. 1 = Yesterday, 7 = Last 7 days, 30 = Last 30 days.", "default": "7" }, "week": { "title": "📅 Specific Week", "type": "string", "description": "When period_type is 'week', enter the week start date in YYYY-MM-DD format (e.g. 2026-01-01). Only used when Period Type is 'Specific Week'.", "default": "" }, "month": { "title": "📅 Specific Month", "type": "string", "description": "When period_type is 'month', enter the month in YYYY-MM format (e.g. 2025-01). Only used when Period Type is 'Specific Month'.", "default": "" }, "page": { "title": "📄 Start Page Number", "minimum": 1, "type": "integer", "description": "The page number to start scraping from. Default: 1.", "default": 1 }, "country_code": { "title": "🌍 Country", "enum": [ "", "AR", "AU", "AT", "BH", "BY", "BE", "BR", "KH", "CA", "CL", "CO", "CZ", "DK", "EC", "EG", "FI", "FR", "DE", "GR", "HU", "ID", "IQ", "IE", "IL", "IT", "JP", "JO", "KZ", "KW", "LB", "MY", "MX", "MA", "NL", "NZ", "NO", "OM", "PK", "PE", "PH", "PL", "PT", "QA", "RO", "SA", "SG", "ZA", "KR", "ES", "SE", "CH", "TW", "TH", "TR", "AE", "GB", "US", "UY", "VN" ], "type": "string", "description": "Select a country to filter products by region. Leave empty for all countries.", "default": "" }, "ecom_type": { "title": "📦 Product Level", "enum": [ "l3", "l2" ], "type": "string", "description": "Select the product granularity level. 'Product' shows individual product categories, 'Subcategory' shows broader subcategories.", "default": "l3" }, "order_by": { "title": "📈 Sort By", "enum": [ "post", "post_change", "ctr", "cvr", "cpa", "cost", "like", "share", "comment", "impression", "play_six_rate" ], "type": "string", "description": "Sort products by a specific metric.", "default": "post" }, "order_type": { "title": "🔄 Sort Order", "enum": [ "desc", "asc" ], "type": "string", "description": "Sort direction - descending (highest first) or ascending (lowest first).", "default": "desc" }, "first_ecom_category_id": { "title": "🏷️ Category Filter", "enum": [ "", "605196", "809488", "929928", "930056", "930184", "940424", "940296", "940808", "940936", "809616", "940680", "602284", "879112", "877320", "961928", "878216", "878600", "878984", "877576", "879496", "880008", "877832", "601450", "849160", "849544", "849800", "848904", "849032", "848648", "849288", "849672", "849416", "848776", "981128", "801928", "989704", "989320", "992904", "927112", "992392", "986760", "985736", "990216", "997384", "951432", "952712", "809872", "953352", "937736", "810000", "601755", "828168", "825352", "824840", "829192", "830344", "831112", "826760", "605248", "905224", "905608", "843144", "905352", "905864", "810128", "905480", "700437", "915208", "914696", "914824", "915464", "914952", "809744", "915336", "915080", "604453", "871304", "871432", "871048", "871176", "700645", "950792", "700646", "924424", "949384", "604968", "873096", "872968", "872584", "873352", "872712", "872456", "873224", "872840", "808208", "600001", "851976", "852488", "852232", "852104", "851848", "852360", "852616", "600942", "845320", "844808", "844168", "845064", "953224", "964616", "964360", "955272", "955016", "963848", "964744", "955400", "961800", "964488", "954888", "964104", "964232", "955144", "802184", "802312", "805128", "803592", "806024", "806792", "600024", "859016", "858888", "858760", "859144", "859272", "859400", "858632", "859528", "858504", "824584", "902920", "902792", "902664", "902536", "902408", "824328", "840072", "840584", "840328", "840712", "839944", "840456", "601303", "601304", "601343", "838920", "601339", "601325", "601331", "601348", "839176", "601310", "602118", "821896", "818696", "813960", "812168", "812808", "816392", "818184", "815624", "1001992", "819848", "821000", "822792", "601739", "909448", "909320", "909192", "909704", "909064", "995976", "909576", "984584", "978952", "601352", "900616", "900744", "900488", "603014", "834952", "835464", "936712", "835336", "835592", "834568", "834824", "834696", "835080", "835208", "600154", "808328", "811016", "809992", "604579", "871944", "871688", "872328", "871816", "871560", "980488", "872072", "872200", "604206", "860296", "951560", "859656", "859784", "860040", "860168", "860552", "859912", "834312", "996360", "601152", "842376", "842504", "843016", "842632", "842760", "842248", "842888" ], "type": "string", "description": "Select a product category to filter trending products. Leave empty for all categories.", "default": "" }, "keyword": { "title": "🔍 Search Keyword", "type": "string", "description": "Search for products by keyword. Leave empty to not filter by keyword.", "default": "" }, "maxResults": { "title": "🎯 Max Results", "minimum": 0, "type": "integer", "description": "Maximum number of products to scrape. Set to 0 for unlimited. Default: 100.", "default": 20 }, "limit": { "title": "📐 Results Per Page", "minimum": 1, "maximum": 20, "type": "integer", "description": "Number of products 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 } } } } } } } } } } ```