# TikTok Profile Scraper (`parseforge/tiktok-profile-scraper`) Actor Scrape TikTok user profiles at scale. Extract follower counts, bio, verification status, hearts, video count, account flags, and recent videos with engagement metrics. Optionally collect comments per video. Filter by date, hearts, and pinned status. No login required. - **URL**: https://apify.com/parseforge/tiktok-profile-scraper.md - **Developed by:** [ParseForge](https://apify.com/parseforge) (community) - **Categories:** Social media, Lead generation, Other - **Stats:** 23 total users, 5 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event 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 Profile Scraper Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true) ## πŸ“± TikTok Profile Scraper > πŸ•’ **Last updated:** 2026-05-05 Whether you're a social media manager evaluating influencer partnerships, a marketer benchmarking competitor accounts, or a researcher studying creator growth trends, this actor makes it easy to collect structured TikTok profile data from any public account - no login required. > **The TikTok Profile Scraper extracts follower counts, bio, verification status, heart counts, video stats, and recent videos with engagement metrics, plus optional comment extraction for deeper analysis.** ### ✨ What Does It Do - πŸ‘€ **Profile details** - Username, nickname, avatar, bio, bio link, verification status, and account creation date for every profile - πŸ“Š **Engagement metrics** - Follower count, following count, total hearts, video count, and digg count in one structured output - 🎬 **Recent videos** - Optionally scrape videos with play counts, likes, shares, comments, duration, music info, hashtags, and mentions - πŸ’¬ **Video comments** - Extract top comments per video with usernames, like counts, reply counts, and timestamps - πŸ” **Video filters** - Filter videos by publication date, heart count range, and pinned status - 🏒 **Account flags** - Private account, organization, commerce user, TT seller, and content settings (duet, stitch, download) ### 🎬 Demo Video _Coming soon_ ### πŸ”§ Input Start by entering TikTok usernames or profile URLs. The scraper accepts any format - plain usernames like `charlidamelio`, handles like `@khaby.lame`, or full profile URLs like `https://www.tiktok.com/@bellapoarch`. Set **Max Items** to control the total number of profiles to process. Each profile is scraped individually with full stats. Enable **Include Videos** to scrape recent videos for each profile. Videos are nested inside the profile output with full engagement data. Use **Max Videos Per Profile** to control how many videos per account (default 30, max 500). Use **Videos Published After** and **Videos Published Before** (YYYY-MM-DD format) to narrow the date range. Set **Min Hearts** or **Max Hearts** to filter videos by engagement level. Enable **Exclude Pinned Posts** for chronologically accurate results. Enable **Include Comments** to extract comments for each video. Comments are nested inside each video object with username, text, likes, and reply count. ```json { "profiles": ["charlidamelio", "@khaby.lame", "https://www.tiktok.com/@bellapoarch"], "maxItems": 10, "includeVideos": true, "maxVideosPerProfile": 30, "includeComments": true, "maxCommentsPerVideo": 20 } ```` ### πŸ“Š Output | Field | Example | |---|---| | πŸ–ΌοΈ avatarUrl | `https://p16-sign.tiktokcdn.com/...` | | 🌐 profileUrl | `https://www.tiktok.com/@charlidamelio` | | πŸ‘€ username | `charlidamelio` | | πŸ“› nickname | `Charli D'Amelio` | | βœ… verified | `true` | | πŸ“ signature | `hi, it's charli` | | πŸ”— bioLink | `https://linkin.bio/charlidamelio` | | πŸ‘₯ followerCount | `155200000` | | ❀️ heartCount | `11800000000` | | 🎬 videoCount | `2540` | | 🏒 isOrganization | `false` | | πŸ”’ isPrivate | `false` | ```json { "avatarUrl": "https://p16-sign.tiktokcdn.com/.../avatar.jpeg", "profileUrl": "https://www.tiktok.com/@charlidamelio", "username": "charlidamelio", "nickname": "Charli D'Amelio", "verified": true, "signature": "hi, it's charli", "bioLink": "https://linkin.bio/charlidamelio", "followerCount": 155200000, "followingCount": 1284, "heartCount": 11800000000, "videoCount": 2540, "diggCount": 45700, "friendCount": 0, "isPrivate": false, "isOrganization": false, "isCommerceUser": false, "isTtSeller": false, "userId": "5831967", "language": "en", "createTime": "2019-05-01T00:00:00.000Z", "scrapedAt": "2026-03-20T20:30:00.000Z" } ``` ### πŸ’Ž Why Choose the TikTok Profile Scraper? | Feature | Our Actor | Alternative | |---|---|---| | Profile + Videos + Comments | All in one nested output | Separate actors for each | | Video filtering | Date range, heart count, pinned exclusion | Usually no filtering | | Comment extraction | Up to 500 comments per video | Rarely included | | Account metadata | Commerce, seller, organization flags | Basic stats only | | Content settings | Duet, stitch, download permissions | Not available | | No login required | Works without TikTok credentials | Many require cookies | | Batch processing | 10 profiles in parallel per batch | Usually one at a time | ### πŸ“‹ How to Use 1. **Sign Up** - [Create a free account w/ $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) on Apify 2. **Configure** - Enter TikTok usernames or profile URLs, enable video and comment scraping if needed 3. **Run It** - Click Start and download your results as JSON, CSV, or Excel That's it. No coding, no setup, no TikTok login needed. ### 🎯 Business Use Cases - πŸ“± **Social media manager** - Audit influencer accounts before partnerships by checking follower-to-heart ratios, content frequency, and audience engagement patterns across their recent videos - πŸ“Š **Digital marketer** - Track competitor TikTok growth over time, identify which content formats drive engagement, and benchmark your brand's performance against industry leaders - πŸ”¬ **Market researcher** - Study creator demographics and content strategies at scale, analyze trending music and hashtags across accounts, and build datasets for academic research - 🏒 **Brand analyst** - Monitor how creators in your niche perform, track commerce account adoption, and measure the effectiveness of TikTok as a sales channel - 🎨 **Content creator** - Benchmark your stats against top creators, find trending formats and sounds, and identify collaboration opportunities based on complementary audience sizes *** ### ✨ Why choose this Actor | | Capability | |---|---| | 🎯 | **Built for the job.** Scoped specifically to this data source so you skip the parser engineering entirely. | | πŸ”– | **Structured output.** Clean, typed fields ready for analysis, dashboards, or downstream pipelines. | | ⚑ | **Fast.** Optimized request patterns return results in seconds, not minutes. | | πŸ” | **Always fresh.** Every run pulls live data, so the dataset reflects the source as of run time. | | 🌐 | **No infra to manage.** Apify handles proxies, retries, scaling, scheduling, and storage. | | πŸ›‘οΈ | **Reliable.** Battle-tested across many runs and edge cases, with graceful error handling. | | 🚫 | **No code required.** Configure in the UI, run from CLI, schedule via cron, or call from any language with the Apify SDK. | > πŸ“Š Production-grade structured data without the engineering overhead of building and maintaining your own scraper. *** ### πŸ“ˆ How it compares to alternatives | Approach | Cost | Coverage | Refresh | Filters | Setup | |---|---|---|---|---|---| | **⭐ TikTok Profile Scraper** *(this Actor)* | $5 free credit, then pay-per-use | Full source coverage | **Live per run** | Source-native filters supported | ⚑ 2 min | | Build your own scraper | Engineering hours | Full once built | Whenever you maintain it | Custom code | 🐒 Days to weeks | | Paid managed APIs | $$$ monthly | Vendor-defined | Live | Vendor-defined | ⏳ Hours | | Third-party data dumps | Varies | Subset, often stale | Periodic | None | πŸ•’ Variable | Pick this Actor when you want broad coverage, server-side filtering, and no pipeline maintenance. *** ### πŸš€ How to use 1. πŸ“ **Sign up.** [Create a free account with $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) (takes 2 minutes). 2. 🌐 **Open the Actor.** Go to the TikTok Profile Scraper page on the Apify Store. 3. 🎯 **Set input.** Configure the input fields in the form (or paste a JSON), then set `maxItems`. 4. πŸš€ **Run it.** Click **Start** and let the Actor collect your data. 5. πŸ“₯ **Download.** Grab your results in the **Dataset** tab as CSV, Excel, JSON, or XML. > ⏱️ Total time from signup to downloaded dataset: **3-5 minutes.** No coding required. *** ### πŸ’Ό Business use cases
#### πŸ“Š Data & Analytics - Build trend reports and dashboards from live source data - Feed BI tools, warehouses, and ML pipelines with structured records - Run periodic snapshots to track changes over time - Compare segments, regions, or categories with consistent fields #### 🏒 Operations & Strategy - Monitor competitor moves, pricing, and inventory shifts - Build internal directories and lookup tools backed by current data - Power workflows that depend on fresh source records - Cut manual data-gathering time from hours to minutes
#### 🎯 Marketing & Growth - Identify market opportunities and trending topics - Research target audiences and customer personas at scale - Power lead-generation pipelines with verified records - Track sentiment, reviews, or social signals over time #### πŸ› οΈ Engineering & Product - Prototype features that need real-world data without owning a crawler - Replace fragile in-house scrapers with a managed Actor - Wire datasets into your apps via the Apify API or webhooks - Skip the proxy, retry, and parsing maintenance entirely
*** ### 🌟 Beyond business use cases Data like this powers more than commercial workflows. The same structured records support research, education, civic projects, and personal initiatives.
#### πŸŽ“ Research and academia - Empirical datasets for papers, thesis work, and coursework - Longitudinal studies tracking changes across snapshots - Reproducible research with cited, versioned data pulls - Classroom exercises on data analysis and ethical scraping #### 🎨 Personal and creative - Side projects, portfolio demos, and indie app launches - Data visualizations, dashboards, and infographics - Content research for bloggers, YouTubers, and podcasters - Hobbyist collections and personal trackers
#### 🀝 Non-profit and civic - Transparency reporting and accountability projects - Advocacy campaigns backed by public-interest data - Community-run databases for local issues - Investigative journalism on public records #### πŸ§ͺ Experimentation - Prototype AI and machine-learning pipelines with real data - Validate product-market hypotheses before engineering spend - Train small domain-specific models on niche corpora - Test dashboard concepts with live input
### πŸ€– Ask an AI assistant about this scraper Open a ready-to-send prompt about this ParseForge actor in the AI of your choice: - πŸ’¬ [**ChatGPT**](https://chat.openai.com/?q=How%20do%20I%20use%20the%20TIKTOK%20PROFILE%20SCRAPER%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - 🧠 [**Claude**](https://claude.ai/new?q=How%20do%20I%20use%20the%20TIKTOK%20PROFILE%20SCRAPER%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - πŸ” [**Perplexity**](https://perplexity.ai/search?q=How%20do%20I%20use%20the%20TIKTOK%20PROFILE%20SCRAPER%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - πŸ…’ [**Copilot**](https://copilot.microsoft.com/?q=How%20do%20I%20use%20the%20TIKTOK%20PROFILE%20SCRAPER%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) *** ### ❓ Frequently Asked Questions - πŸ”‘ **Do I need a TikTok account?** No. Profile data is collected from public pages without any login or credentials. - 🎬 **How does video scraping work?** When enabled, the scraper opens each profile in a browser and captures video data as the page loads. This requires more time and resources than profile-only scraping. - πŸ’¬ **How many comments can I get?** Up to 500 comments per video. Comments are fetched in batches of 20 and include username, text, likes, and reply count. - πŸ”’ **Can I scrape private profiles?** No. Private profiles are automatically skipped with a warning message. - ⚑ **How fast is profile-only scraping?** Very fast - 10 profiles per batch in parallel, typically completing in a few seconds per batch. - πŸ“… **Can I filter videos by date?** Yes. Use the Published After and Published Before fields with YYYY-MM-DD format to narrow the date range. ### πŸ”— Integrate TikTok Profile Scraper with any app - [Make](https://docs.apify.com/platform/integrations/make) - Connect TikTok profile data to thousands of apps with visual workflows - [Zapier](https://docs.apify.com/platform/integrations/zapier) - Automate actions when new profile data is collected - [GitHub](https://docs.apify.com/platform/integrations/github) - Store and version your scraping configurations - [Slack](https://docs.apify.com/platform/integrations/slack) - Get notifications when scraping runs complete - [Airbyte](https://docs.apify.com/platform/integrations/airbyte) - Sync profile data to your data warehouse - [Google Drive](https://docs.apify.com/platform/integrations/drive) - Export results directly to spreadsheets ### πŸ”Œ Integrate with any app TikTok Profile Scraper connects to any cloud service via [Apify integrations](https://apify.com/integrations): - [**Make**](https://docs.apify.com/platform/integrations/make) - Automate multi-step workflows - [**Zapier**](https://docs.apify.com/platform/integrations/zapier) - Connect with 5,000+ apps - [**Slack**](https://docs.apify.com/platform/integrations/slack) - Get run notifications in your channels - [**Airbyte**](https://docs.apify.com/platform/integrations/airbyte) - Pipe results into your warehouse - [**GitHub**](https://docs.apify.com/platform/integrations/github) - Trigger runs from commits and releases - [**Google Drive**](https://docs.apify.com/platform/integrations/drive) - Export datasets straight to Sheets You can also use webhooks to trigger downstream actions when a run finishes. Push fresh data into your product backend, or alert your team in Slack. *** ### πŸ’‘ More ParseForge Actors - [TikTok Hashtag Analytics Scraper](https://apify.com/parseforge/tiktok-hashtag-analytics-scraper) - Collect TikTok hashtag data and video engagement metrics at scale - [Instagram Posts, Comments & Profiles Scraper](https://apify.com/parseforge/instagram-scraper) - Extract posts, comments, hashtags, and full profile data from Instagram - [Reddit Posts Scraper](https://apify.com/parseforge/reddit-posts-scraper) - Extract posts, comments, and discussions from any subreddit Browse our complete collection of [data collection actors](https://apify.com/parseforge) to find the right tool for your project. ### πŸš€ Ready to Start? [Create a free account w/ $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) and start collecting TikTok profile data in minutes. ### πŸ†˜ Need Help? - Check the FAQ section above for common questions - Read the [Apify documentation](https://docs.apify.com) for platform guides - Contact us to request a new scraper, propose a custom data project, or report a technical issue with this actor at https://tally.so/r/BzdKgA ### ⚠️ Disclaimer > This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by TikTok or ByteDance Ltd. All trademarks mentioned are the property of their respective owners. *** ### πŸ”— Recommended Actors - [**πŸ” Google Search Scraper**](https://apify.com/parseforge/google-search-scraper) - Multi-engine SERP results with country and language targeting - [**πŸ—ΊοΈ Nominatim OSM Scraper**](https://apify.com/parseforge/nominatim-osm-scraper) - Geocode addresses via OpenStreetMap - [**πŸ“Š Indexmundi Scraper**](https://apify.com/parseforge/indexmundi-scraper) - Global demographic and economic indicators - [**πŸ“° RAG Web Browser**](https://apify.com/parseforge/rag-web-browser) - Crawl and extract clean text from any URL for AI retrieval - [**🌐 Website Content Crawler**](https://apify.com/parseforge/website-content-crawler) - Crawl entire sites and export structured content > πŸ’‘ **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge) for more reference-data scrapers. # Actor input Schema ## `profiles` (type: `array`): List of TikTok usernames or profile URLs to scrape (e.g. 'charlidamelio', '@khaby.lame', 'https://www.tiktok.com/@bellapoarch') ## `maxItems` (type: `integer`): Free users: Limited to 100. Paid users: Optional, max 1,000,000 ## `includeVideos` (type: `boolean`): Scrape recent videos for each profile. Videos are nested inside each profile's output. ## `maxVideosPerProfile` (type: `integer`): Maximum number of videos to scrape per profile ## `publishedAfter` (type: `string`): Only include videos published after this date (YYYY-MM-DD format) ## `publishedBefore` (type: `string`): Only include videos published before this date (YYYY-MM-DD format) ## `minHearts` (type: `integer`): Only include videos with at least this many hearts/likes ## `maxHearts` (type: `integer`): Only include videos with at most this many hearts/likes ## `excludePinned` (type: `boolean`): Exclude pinned videos from the results ## `includeComments` (type: `boolean`): Scrape comments for each video. Comments are nested inside each video. ## `maxCommentsPerVideo` (type: `integer`): Maximum number of comments to scrape per video ## Actor input object example ```json { "profiles": [ "charlidamelio", "addisonre", "bellapoarch", "zachking", "khaby.lame", "willsmith", "kyliejenner", "therock", "selenagomez", "arianagrande", "billieeilish", "mrbeast", "doja.cat", "mileycyrus", "jasonderulo", "jlo", "shakira", "taylorswift", "kimkardashian", "rihanna", "nickiminaj", "cardib", "badbunnypr", "dualipa", "edsheeran", "brunomars", "kendalljenner", "mariahcarey", "justinbieber", "ninaagdal" ], "maxItems": 10, "includeVideos": false, "maxVideosPerProfile": 30, "excludePinned": false, "includeComments": false, "maxCommentsPerVideo": 20 } ``` # Actor output Schema ## `results` (type: `string`): Dataset with all scraped TikTok profiles # 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 = { "profiles": [ "charlidamelio", "addisonre", "bellapoarch", "zachking", "khaby.lame", "willsmith", "kyliejenner", "therock", "selenagomez", "arianagrande", "billieeilish", "mrbeast", "doja.cat", "mileycyrus", "jasonderulo", "jlo", "shakira", "taylorswift", "kimkardashian", "rihanna", "nickiminaj", "cardib", "badbunnypr", "dualipa", "edsheeran", "brunomars", "kendalljenner", "mariahcarey", "justinbieber", "ninaagdal" ], "maxItems": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("parseforge/tiktok-profile-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 = { "profiles": [ "charlidamelio", "addisonre", "bellapoarch", "zachking", "khaby.lame", "willsmith", "kyliejenner", "therock", "selenagomez", "arianagrande", "billieeilish", "mrbeast", "doja.cat", "mileycyrus", "jasonderulo", "jlo", "shakira", "taylorswift", "kimkardashian", "rihanna", "nickiminaj", "cardib", "badbunnypr", "dualipa", "edsheeran", "brunomars", "kendalljenner", "mariahcarey", "justinbieber", "ninaagdal", ], "maxItems": 10, } # Run the Actor and wait for it to finish run = client.actor("parseforge/tiktok-profile-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 '{ "profiles": [ "charlidamelio", "addisonre", "bellapoarch", "zachking", "khaby.lame", "willsmith", "kyliejenner", "therock", "selenagomez", "arianagrande", "billieeilish", "mrbeast", "doja.cat", "mileycyrus", "jasonderulo", "jlo", "shakira", "taylorswift", "kimkardashian", "rihanna", "nickiminaj", "cardib", "badbunnypr", "dualipa", "edsheeran", "brunomars", "kendalljenner", "mariahcarey", "justinbieber", "ninaagdal" ], "maxItems": 10 }' | apify call parseforge/tiktok-profile-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=parseforge/tiktok-profile-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "TikTok Profile Scraper", "description": "Scrape TikTok user profiles at scale. Extract follower counts, bio, verification status, hearts, video count, account flags, and recent videos with engagement metrics. Optionally collect comments per video. Filter by date, hearts, and pinned status. No login required.", "version": "1.0", "x-build-id": "T3ROhp6xKRveScQdV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~tiktok-profile-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-tiktok-profile-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/parseforge~tiktok-profile-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-tiktok-profile-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/parseforge~tiktok-profile-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-tiktok-profile-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": { "profiles": { "title": "Profile(s)", "type": "array", "description": "List of TikTok usernames or profile URLs to scrape (e.g. 'charlidamelio', '@khaby.lame', 'https://www.tiktok.com/@bellapoarch')", "items": { "type": "string" } }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 100. Paid users: Optional, max 1,000,000" }, "includeVideos": { "title": "Include Videos", "type": "boolean", "description": "Scrape recent videos for each profile. Videos are nested inside each profile's output.", "default": false }, "maxVideosPerProfile": { "title": "Max Videos Per Profile", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of videos to scrape per profile", "default": 30 }, "publishedAfter": { "title": "Videos Published After", "type": "string", "description": "Only include videos published after this date (YYYY-MM-DD format)" }, "publishedBefore": { "title": "Videos Published Before", "type": "string", "description": "Only include videos published before this date (YYYY-MM-DD format)" }, "minHearts": { "title": "Min Hearts", "type": "integer", "description": "Only include videos with at least this many hearts/likes" }, "maxHearts": { "title": "Max Hearts", "type": "integer", "description": "Only include videos with at most this many hearts/likes" }, "excludePinned": { "title": "Exclude Pinned Posts", "type": "boolean", "description": "Exclude pinned videos from the results", "default": false }, "includeComments": { "title": "Include Comments", "type": "boolean", "description": "Scrape comments for each video. Comments are nested inside each video.", "default": false }, "maxCommentsPerVideo": { "title": "Max Comments Per Video", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of comments to scrape per video", "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 } } } } } } } } } } ```