# TikTok Creator Scraper (`agentx/tiktok-creator-scraper`) Actor TikTok creator-intelligence API: video performance signals (TikTok Score, Recommend Type), audience metrics, audio and SEO metadata, monetization indicators. JSON feed for creator-marketing CRMs and brand-sponsorship targeting. - **URL**: https://apify.com/agentx/tiktok-creator-scraper.md - **Developed by:** [AgentX](https://apify.com/agentx) (community) - **Categories:** Social media, Videos, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 2 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $4.90 / 1,000 videos 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 Creator Scraper - Creator Profile Extraction & Video Analytics API **Extract 50+ data fields per video from any TikTok creator profile — including hidden SEO metadata, engagement forensics, algorithm recommendation types, nested comment trees, and audio metadata.** This API delivers structured creator intelligence with follower metrics, video history, quality scores (VQScore), content permissions, and commercial music licensing data for influencer vetting, competitor analysis, and creator economy research pipelines. [![TikTok](https://img.shields.io/badge/TikTok-ffd700?style=for-the-badge&color=ffd700)](https://apify.com/agentx/tiktok-creator-scraper?fpr=aiagentapi) [![50+ Fields](https://img.shields.io/badge/50+_Fields-ffd700?style=for-the-badge&color=ffd700)](https://apify.com/agentx/tiktok-creator-scraper?fpr=aiagentapi) [![SEO Data](https://img.shields.io/badge/SEO_Metadata-ffd700?style=for-the-badge&color=ffd700)](https://apify.com/agentx/tiktok-creator-scraper?fpr=aiagentapi) --- ### Why Choose This API #### 50+ Field TikTok Creator Intelligence with Hidden SEO Data **🔍 Hidden SEO Metadata Extraction** Extract TikTok-generated SEO titles, descriptions, tags, and keywords invisible to manual inspection — revealing how TikTok's algorithm categorizes and distributes content. **📈 Algorithm Intelligence** Decode VQScore (video quality score), recommendation types (for_you, gaming, cross_promotion, effect_related), and platform-assigned categories for content strategy reverse-engineering. **💬 Nested Comment Intelligence** Complete comment trees with parent-child reply chains, engagement metrics, pinned/liked markers, and sentiment data for audience analysis. **🎵 Audio & Music Metadata** Music ID, title, author, duration, copyright status, and commercial permissions with optional MP3 download for content licensing research. --- ### Quick Start Guide #### How to Extract TikTok Creator Data in 3 Steps ##### Step 1: Configure Parameters Enter a TikTok profile URL or @username, select content type, and set video/comment limits. ##### Step 2: Run the Actor Click "Start" to begin profile extraction. Videos are processed newest-first with progress tracking. ##### Step 3: Access Structured Data Download JSON dataset with 50+ fields per video including SEO data, comments, and audio metadata. #### Example Input ```json { "tiktok_url": "https://www.tiktok.com/@mrbeast", "content_type": "Videos", "max_videos": 30, "max_comments": 50, "download_music": false } ```` *** ### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | **🔗 TikTok URL** | String | Yes | Profile URL or @username | | **📹 Content Type** | String | Yes | Tab to extract: Videos, Reposts, or Liked | | **📊 Max Videos** | Integer | Yes | Maximum videos to extract (newest first) | | **💬 Max Comments** | Integer | Yes | Max comments per video including replies (0 to skip) | | **🎵 Download Music** | Boolean | Yes | Download original music files (MP3) | *** ### Output Data Schema Each extracted video returns comprehensive creator and content intelligence: #### Output Fields | Field | Type | Description | |-------|------|-------------| | **id** | String | Unique TikTok video identifier | | **url** | String | TikTok video page URL | | **created\_at** | String | ISO 8601 creation timestamp | | **description** | String | Video caption/description | | **quality\_score** | String | TikTok internal VQScore | | **play\_count** | Integer | Number of video plays | | **like\_count** | Integer | Number of likes | | **comment\_count** | Integer | Number of comments | | **share\_count** | Integer | Number of shares | | **collect\_count** | Integer | Number of saves/collects | | **category** | String | Platform-assigned video category | | **recommend\_type** | String | Algorithm recommendation channel | | **hashtags** | Array | Hashtags used | | **seo\_title** | String | TikTok-generated SEO title | | **seo\_description** | String | TikTok-generated SEO description | | **seo\_tags** | Array | TikTok-assigned SEO tags | | **seo\_keywords** | Array | TikTok-assigned SEO keywords | | **author\_name** | String | Creator username | | **author\_followers** | Integer | Total follower count | | **author\_verified** | Boolean | Verification status | | **music\_title** | String | Music track title | | **music\_copyrighted** | Boolean | Copyright status | | **music\_commerce** | Boolean | Commercial use permission | | **comments** | Array | Nested comment threads | #### Example Output ```json { "processor": "https://apify.com/agentx/tiktok-creator-scraper?fpr=aiagentapi", "processed_at": "2025-01-15T08:12:31+00:00", "id": "7554428159052008717", "url": "https://www.tiktok.com/@mrbeastlab/video/7554428159052008717", "description": "🔥 The all-new animated series premieres October 26.", "quality_score": "64.65", "play_count": 560500, "like_count": 25100, "comment_count": 907, "share_count": 887, "category": "other", "recommend_type": "effect_related", "hashtags": ["mrbeastlabstoyspartner"], "seo_title": "MrBeast Labs Animated Series Premieres Soon!", "author_name": "mrbeastlab", "author_verified": true, "author_followers": 173600, "comments": [ { "id": "7558561176227447565", "name": "goobygio", "text": "That voice actor sounds EXACTLY like Mr. Beast", "like_count": 181, "reply_count": 5 } ] } ``` *** ### Integration Examples #### Python Integration Example ```python from apify_client import ApifyClient client = ApifyClient("YOUR_API_TOKEN") run_input = { "tiktok_url": "https://www.tiktok.com/@mrbeast", "content_type": "Videos", "max_videos": 30, "max_comments": 50, "download_music": False } run = client.actor("p5WWQg8bwnUMT9SJw").call(run_input=run_input) dataset_items = client.dataset(run["defaultDatasetId"]).list_items().items for video in dataset_items: print(f"{video['description'][:50]} | {video['play_count']} plays | VQ: {video['quality_score']}") ``` #### JavaScript/Node.js Integration ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_API_TOKEN' }); const input = { tiktok_url: 'https://www.tiktok.com/@mrbeast', content_type: 'Videos', max_videos: 30, max_comments: 50, download_music: false }; const run = await client.actor("p5WWQg8bwnUMT9SJw").call(input); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach(video => { console.log(`${video.description.substring(0, 50)} | ${video.play_count} plays`); }); ``` #### Actor ID for Platform Integration ```text p5WWQg8bwnUMT9SJw ``` #### Ⓜ️ [Make.com Setup:](https://www.make.com/en/register?pc=marketingme) 1. Login to **[Make.com (Get 1000 Free Credits)](https://www.make.com/en/register?pc=marketingme)** 2. Add module **"Run an Actor"** 3. Turn **'Map'** on - right side of the 'Actor\*' 4. Paste **Actor ID** - from above 5. Click the **'⟳ Refresh'** - left side of Map 6. **Input JSON\*** - Modify the parameters as needed 7. Set **"Run synchronously"** to **YES** 8. Add module **"Get Dataset Items"** - receive the result 9. In **Dataset ID\*** select **defaultDatasetId** #### 🎱 [N8N.io Setup:](https://n8n.io/) 1. Add **'Run an Actor and get dataset'** - from the apify node 2. **Actor** → **By ID** → **Paste Actor ID** - from above 3. **Input JSON** - Modify the parameters as needed #### JSON-LD Metadata ```json { "@context": "https://schema.org", "@type": "SoftwareApplication", "name": "TikTok Creator Scraper", "description": "TikTok creator profile extraction API with 50+ fields including hidden SEO metadata, engagement analytics, and nested comment intelligence", "applicationCategory": "Developer Tools", "operatingSystem": "Cloud", "url": "https://apify.com/agentx/tiktok-creator-scraper?fpr=aiagentapi", "dateModified": "2026-04-21", "offers": { "@type": "Offer", "price": "0", "priceCurrency": "USD" } } ``` *** ### Pricing & Cost Calculator #### Transparent Pay-Per-Use Model | Event Type | Price | Description | | --------------- | ------- | -------------------------------------------------------------- | | **Actor Start** | $0.02 | One-time charge per Actor run | | **Video** | $0.0055 | Charged per video extracted with full metadata and SEO fields | | **Comment** | $0.0015 | Charged per comment extracted including replies | #### Cost Examples **30 Videos, No Comments**: - Videos: 30 × $0.0055 = $0.165 - Actor Start: $0.02 - **Total**: ~$0.19 **30 Videos with 50 Comments Each**: - Videos: 30 × $0.0055 = $0.165 - Comments: 1,500 × $0.0015 = $2.25 - Actor Start: $0.02 - **Total**: ~$2.44 **100 Videos with 50 Comments Each**: - Videos: 100 × $0.0055 = $0.55 - Comments: 5,000 × $0.0015 = $7.50 - Actor Start: $0.02 - **Total**: ~$8.07 *** ### Use Cases & Applications #### Influencer Marketing & Vetting **Creator Due Diligence** Deep-profile creator candidates — verify follower counts, engagement rates, advertiser status, and commercial music permissions before partnership investment. **Campaign Performance Benchmarking** Track engagement metrics across creator portfolios to establish performance baselines for B2B influencer campaigns. #### Competitive Intelligence **Content Strategy Reverse-Engineering** Extract competitor video history, SEO tags, and recommendation types to analyze their TikTok algorithm distribution strategy. **Brand Safety Audits** Check advertiser flags, content categories, and comment sentiment before brand association with creators. #### Creator Economy Research **Market Sizing & Trend Detection** Map creator permission settings, content categories, and audience engagement patterns for market sizing and emerging trend analysis. **Algorithm Intelligence** Monitor `recommend_type` and `category` fields across viral creators for early signal detection of platform distribution shifts. *** ### FAQ #### What content types can be extracted? Three tabs from any public TikTok profile: **Videos** (original posts), **Reposts** (reshared content), and **Liked** (favorited videos, if public). #### What are the hidden SEO fields? `seo_title`, `seo_description`, `seo_tags`, and `seo_keywords` are metadata generated by TikTok's algorithm — invisible on the platform but revealing how TikTok categorizes and distributes content. #### Are nested comments included? Yes — full parent-child reply structures with engagement metrics, pinned/liked markers, and visibility status. Set `max_comments: 0` to skip. #### Can I download actual video files? This actor focuses on metadata and intelligence. For video downloads, use **[All Video Scraper](https://apify.com/agentx/all-video-scraper?fpr=aiagentapi)**. #### How does pricing work? There is no per-record extraction fee. You only pay for Apify platform compute resources such as memory, execution time, and storage consumed during the run. *** ### SEO Keywords & Search Terms #### Primary Keywords tiktok creator scraper API, tiktok profile extraction, tiktok influencer data API, tiktok creator analytics, tiktok SEO metadata extractor, tiktok engagement intelligence #### Long-Tail Keywords extract tiktok creator profile 50 fields SEO metadata API, tiktok influencer vetting pipeline structured JSON, tiktok algorithm recommendation type extraction #### Industry Terms creator intelligence, influencer vetting, TikTok algorithm analysis, creator economy research, content strategy extraction, engagement forensics *** ### Trust & Certifications - ✅ **Enterprise Ready** - Processing creator intelligence at scale - ✅ **GDPR Compliant** - EU data protection standards - ✅ **50+ Fields** - Including hidden SEO metadata - ✅ **Regular Updates** - Continuous maintenance for platform changes *** ### Legal & Compliance #### Data Rights & Usage All data is extracted from publicly available TikTok profiles. Users are responsible for ensuring their use of extracted data complies with applicable laws and TikTok's Terms of Service. #### Privacy Compliance - **GDPR**: Compliant with EU General Data Protection Regulation. No personal data is stored beyond the extraction session. - **CCPA**: Compliant with California Consumer Privacy Act requirements. #### Platform Terms of Service Users must review and comply with TikTok's Terms of Service and Developer Terms regarding data extraction and usage. #### Enterprise Support For enterprise licensing, custom integrations, or compliance inquiries: - **Telegram**: [@AiAgentApi](https://t.me/AiAgentApi) *** ### Related Tools #### Jobs & Hiring - **[All Job Scraper](https://apify.com/agentx/all-jobs-scraper?fpr=aiagentapi)** - Multi-Platform Job Data Extraction API - **[Indeed Hiring Scraper](https://apify.com/agentx/indeed-hiring-scraper?fpr=aiagentapi)** - Indeed Job Extraction & Market Intelligence - **[LinkedIn Hiring Scraper](https://apify.com/agentx/linkedin-hiring-scraper?fpr=aiagentapi)** - LinkedIn Job Data Extraction & Talent Intelligence - **[Glassdoor Hiring Scraper](https://apify.com/agentx/glassdoor-hiring-scraper?fpr=aiagentapi)** - Glassdoor Salary Intelligence & Company Reviews #### LinkedIn - **[LinkedIn Company Scraper](https://apify.com/agentx/linkedin-company-scraper?fpr=aiagentapi)** - LinkedIn Company Data Extraction & Firmographic Intelligence - **[LinkedIn Profile Scraper](https://apify.com/agentx/linkedin-profile-scraper?fpr=aiagentapi)** - LinkedIn Profile Data Extraction & Professional Intelligence #### Reddit - **[Reddit Author Scraper](https://apify.com/agentx/reddit-author-scraper?fpr=aiagentapi)** - Reddit Author Profile Extraction & Activity Analysis - **[Reddit Viral Scraper](https://apify.com/agentx/reddit-viral-scraper?fpr=aiagentapi)** - Reddit Viral Content Extraction & Trend Intelligence - **[SubReddit Info Scraper](https://apify.com/agentx/subreddit-info-scraper?fpr=aiagentapi)** - Subreddit Metadata Extraction & Community Intelligence - **[SubReddit Post Scraper](https://apify.com/agentx/subreddit-post-scraper?fpr=aiagentapi)** - Subreddit Post Extraction & Content Analysis - **[Subreddit Member Scraper](https://apify.com/agentx/subreddit-member-scraper?fpr=aiagentapi)** - Subreddit Member Extraction & Audience Analysis #### Telegram - **[Telegram Chat Scraper](https://apify.com/agentx/telegram-chat-scraper?fpr=aiagentapi)** - Telegram Chat Message Extraction & Content Analysis - **[Telegram Group Inviter](https://apify.com/agentx/telegram-group-inviter?fpr=aiagentapi)** - Telegram Group Member Invitation & Management - **[Telegram Info Scraper](https://apify.com/agentx/telegram-info-scraper?fpr=aiagentapi)** - Telegram Entity Metadata Extraction & Intelligence - **[Telegram Member Scraper](https://apify.com/agentx/telegram-member-scraper?fpr=aiagentapi)** - Telegram Group Member Extraction & Audience Data - **[Telegram Private Group Scraper](https://apify.com/agentx/telegram-private-group-scraper?fpr=aiagentapi)** - Telegram Private Group Data Extraction & Analysis #### Instagram - **[Instagram Creator Scraper](https://apify.com/agentx/instagram-creator-scraper?fpr=aiagentapi)** - Instagram Profile Data Extraction & Creator Intelligence - **[Instagram Post Reel Scraper](https://apify.com/agentx/instagram-post-reel-scraper?fpr=aiagentapi)** - Instagram Feed Post & Reel Extraction API - **[Instagram Trending Scraper](https://apify.com/agentx/instagram-trending-scraper?fpr=aiagentapi)** - Instagram Explore Trending Content Extraction API #### X / Twitter - **[Twitter Community Scraper](https://apify.com/agentx/twitter-community-scraper?fpr=aiagentapi)** - Twitter Community Extraction & Member Analysis - **[Twitter Info Scraper](https://apify.com/agentx/twitter-info-scraper?fpr=aiagentapi)** - X/Twitter Profile Extraction & User Intelligence #### TikTok - **[TikTok Creator Scraper](https://apify.com/agentx/tiktok-creator-scraper?fpr=aiagentapi)** - TikTok Creator Profile Extraction & Analytics (This Tool) - **[TikTok Live Downloader](https://apify.com/agentx/tiktok-live-downloader?fpr=aiagentapi)** - TikTok Live Stream Recording & Download - **[TikTok Transcript](https://apify.com/agentx/tiktok-transcript?fpr=aiagentapi)** - TikTok Video Transcription & Content Extraction #### Video & Content - **[All Video Scraper](https://apify.com/agentx/all-video-scraper?fpr=aiagentapi)** - Multi-Platform Video Download & Extraction (1000+ Sites) - **[Video Caption Scraper](https://apify.com/agentx/video-caption-scraper?fpr=aiagentapi)** - Video Caption Extraction & Subtitle Data - **[Video Transcript](https://apify.com/agentx/video-transcript?fpr=aiagentapi)** - Universal Video Transcription & AI Training Data - **[Video to Social Post](https://apify.com/agentx/video-to-social-post?fpr=aiagentapi)** - Video Content Conversion & Social Media Repurposing - **[Live Stream Transcript](https://apify.com/agentx/live-stream-transcript?fpr=aiagentapi)** - Live Stream Transcription & Real-Time Content Extraction #### YouTube - **[YouTube Transcript](https://apify.com/agentx/youtube-transcript?fpr=aiagentapi)** - YouTube Video Transcription & Speech Extraction - **[YouTube Market Intelligence](https://apify.com/agentx/youtube-market-intelligence?fpr=aiagentapi)** - YouTube Channel & Video Metadata Extraction #### Real Estate - **[Realtor Property Scraper](https://apify.com/agentx/realtor-property-scraper?fpr=aiagentapi)** - Realtor.com Property Data Extraction & Market Intelligence - **[Zillow For Sale Scraper](https://apify.com/agentx/zillow-for-sale-scraper?fpr=aiagentapi)** - Zillow Property Listing Extraction & Real Estate Data #### Maps & Local - **[Google Maps Store Scraper](https://apify.com/agentx/google-maps-store-scraper?fpr=aiagentapi)** - Google Maps Business Data Extraction & Local Intelligence *** ### Support & Community - **👥 Community**: [@Apify\_Actor](https://t.me/Apify_Actor) - **👤 Contact Team**: [@AiAgentApi](https://t.me/AiAgentApi) *** **Last Updated:** April 21, 2026 # Actor input Schema ## `tiktok_url` (type: `string`): TikTok profile URL or username. Supports formats: https://www.tiktok.com/@username or just @username ## `content_type` (type: `string`): Select which tab to browse from the TikTok profile page. Videos = user's original posts, Reposts = videos the user reshared ## `max_videos` (type: `integer`): Maximum number of videos to find from the selected content type tab (sorted by newest first) ## `max_comments` (type: `integer`): Maximum comments to get per video including nested replies (set to 0 to skip comments) ## Actor input object example ```json { "tiktok_url": "https://www.tiktok.com/@openai", "content_type": "Videos", "max_videos": 1, "max_comments": 1 } ``` # Actor output Schema ## `results` (type: `string`): All TikTok video details with engagement stats, SEO data, music info, author profiles, and comments # 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 = { "tiktok_url": "https://www.tiktok.com/@openai", "content_type": "Videos", "max_videos": 1, "max_comments": 1 }; // Run the Actor and wait for it to finish const run = await client.actor("agentx/tiktok-creator-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 = { "tiktok_url": "https://www.tiktok.com/@openai", "content_type": "Videos", "max_videos": 1, "max_comments": 1, } # Run the Actor and wait for it to finish run = client.actor("agentx/tiktok-creator-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 '{ "tiktok_url": "https://www.tiktok.com/@openai", "content_type": "Videos", "max_videos": 1, "max_comments": 1 }' | apify call agentx/tiktok-creator-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=agentx/tiktok-creator-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "TikTok Creator Scraper", "description": "TikTok creator-intelligence API: video performance signals (TikTok Score, Recommend Type), audience metrics, audio and SEO metadata, monetization indicators. JSON feed for creator-marketing CRMs and brand-sponsorship targeting.", "version": "0.0", "x-build-id": "uNh4i0XhabktHySmY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/agentx~tiktok-creator-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-agentx-tiktok-creator-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/agentx~tiktok-creator-scraper/runs": { "post": { "operationId": "runs-sync-agentx-tiktok-creator-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/agentx~tiktok-creator-scraper/run-sync": { "post": { "operationId": "run-sync-agentx-tiktok-creator-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", "required": [ "tiktok_url", "content_type", "max_videos", "max_comments" ], "properties": { "tiktok_url": { "title": "🎵 TikTok URL", "type": "string", "description": "TikTok profile URL or username. Supports formats: https://www.tiktok.com/@username or just @username" }, "content_type": { "title": "📂 Content Type", "enum": [ "Videos", "Reposts" ], "type": "string", "description": "Select which tab to browse from the TikTok profile page. Videos = user's original posts, Reposts = videos the user reshared" }, "max_videos": { "title": "🎬 Max Videos", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of videos to find from the selected content type tab (sorted by newest first)" }, "max_comments": { "title": "💬 Max Comments", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Maximum comments to get per video including nested replies (set to 0 to skip comments)" } } }, "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 } } } } } } } } } } ```