# ✅ TikTok User Posts Scraper (`datamagnet/tiktok-profile-info-and-posts`) Actor Get TikTok profile details and recent posts for one or more usernames in a simple run. Enter public usernames, and the actor returns profile info plus recent TikTok posts exactly as provided by the source, helping you research creators, competitors, and content fast. - **URL**: https://apify.com/datamagnet/tiktok-profile-info-and-posts.md - **Developed by:** [Datamagnet](https://apify.com/datamagnet) (community) - **Categories:** Social media, Lead generation, Videos - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 Posts Scraper TikTok Profile Posts Scraper helps you quickly collect TikTok profile details and recent posts for one or more usernames in one simple run. It is ideal for marketers, researchers, agencies, and brand teams who want a fast way to review public TikTok profile info, follower stats, and recent content without manual copying. Enter a username, and the actor gathers the profile data exactly as returned by the source along with the latest posts for that account. If you need TikTok profile lookup, recent post collection, or multi-user content research, this tool gives you a clean, ready-to-use dataset. ### Key Features - Extract TikTok profile details from a username and get the account’s public information in one place. - Collect recent posts for each profile so you can review content, captions, media, and engagement signals. - Gather multiple usernames in a single run to compare creators, competitors, or brand accounts side by side. - Continue collecting posts until your chosen limit is reached, helping you capture enough recent activity for analysis. - Preserve the source data exactly as returned, making it easy to work with the original profile and post fields. - Export results in a format that is easy to sort, filter, share, and analyze in your workflow. - Save time on manual profile checks by automating repetitive TikTok research tasks. ### Use Cases #### Influencer Research Marketing teams use this actor to review TikTok creator profiles before outreach or partnership decisions. The returned profile fields such as nickname, verified status, follower count, bio link, and profile image help teams quickly judge audience size and brand fit. Recent posts, captions, and engagement stats make it easier to see whether the creator’s content style matches a campaign. #### Competitor Monitoring Brands can track competitor TikTok accounts by collecting profile details and recent posts for several usernames at once. Fields like video count, heart count, digg count, share count, and post descriptions help teams understand how active a competitor is and what content themes are performing. This supports faster decisions about content strategy, posting frequency, and creative direction. #### Content Performance Review Social media managers can use the post data to study what a profile is publishing and how audiences respond. Post-level fields such as play count, comment count, share count, cover image, duration, and music details help identify which formats and topics are getting attention. This is useful for building better content calendars and spotting patterns in successful videos. #### Brand Safety Checks Agencies and brand teams can review public profile information before featuring a creator in a campaign. The actor returns account status details like private account, verified badge, and profile metadata, which helps teams confirm whether an account is public and suitable for review. Recent posts also give a quick view of the creator’s current content style and brand alignment. #### Lead List Building Sales and partnership teams can build a shortlist of TikTok accounts to contact by collecting usernames in bulk. The profile fields provide a quick snapshot of account size and identity, while the recent posts show whether the account is active and relevant. This makes it easier to prioritize outreach based on real content activity instead of guesswork. #### Audience and Trend Analysis Researchers and analysts can compare multiple TikTok profiles to understand what kinds of content are being posted in a niche. The actor returns hashtags, mentions, captions, music information, and engagement metrics that help reveal recurring themes and audience interests. This supports trend spotting, category research, and competitive benchmarking. ### Input | Field | Type | Required | Description | Example | |---|---|---:|---|---| | Usernames | array | Yes | Enter one or more TikTok usernames to look up. Use the profile name without the @ symbol. | ["selenagomez", "taylorswift"] | | Max results | integer | No | Set the maximum number of recent posts to collect for each username. | 100 | ### Output | Field | Type | Description | |---|---|---| | AIGCDescription | string | A short source-provided description field, if available. | | CategoryType | integer | A source category value that helps identify the type of content. | | IsHDBitrate | boolean | Shows whether the post includes high-bitrate media. | | ShowAIGC | boolean | Indicates whether AI-related content labeling is shown by the source. | | author | object | Public profile details for the account that posted the content. | | authorStats | object | Main profile statistics such as followers, likes, and video count. | | authorStatsV2 | object | String-based version of the profile statistics from the source. | | backendSourceEventTracking | string | Source tracking information included with the record. | | challenges | array | Hashtags or challenge tags connected to the post. | | collected | boolean | Indicates whether the item was marked as collected by the source. | | contents | array | Caption fragments and tagged mentions included in the post. | | createTime | integer | The time the post was created, in source timestamp format. | | desc | string | The full post caption or description. | | digged | boolean | Shows whether the item was liked by the source account. | | diversificationId | integer | A source classification value for the post. | | duetDisplay | integer | Indicates how duet visibility is handled for the post. | | duetEnabled | boolean | Shows whether duets are allowed for the post. | | forFriend | boolean | Indicates whether the post is shared for friends only. | | id | string | The unique post identifier. | | isAd | boolean | Shows whether the post is marked as an advertisement. | | isReviewing | boolean | Indicates whether the post is under review. | | itemCommentStatus | integer | A source comment-status value for the post. | | item_control | object | Controls related to reposting and other post permissions. | | music | object | Music and sound details used in the post. | | officalItem | boolean | Indicates whether the item is marked as official by the source. | | originalItem | boolean | Shows whether the post is considered original content. | | privateItem | boolean | Indicates whether the post is private. | | secret | boolean | Shows whether the post is hidden or restricted by the source. | | shareEnabled | boolean | Indicates whether sharing is allowed. | | stats | object | Engagement counts such as plays, likes, comments, shares, and saves. | | statsV2 | object | String-based version of the engagement counts from the source. | | stitchDisplay | integer | Indicates how stitch visibility is handled for the post. | | stitchEnabled | boolean | Shows whether stitching is allowed for the post. | | textExtra | array | Tagged users and hashtags found in the caption. | | textLanguage | string | The language detected for the caption text. | | textTranslatable | boolean | Shows whether the caption can be translated by the source. | | video | object | Detailed video information including cover images, size, quality, and playback links. | | profile_username | string | The username used to collect the profile and posts. | | profile | object | Public profile details returned for the username. | ### Sample Output ```json { "AIGCDescription": "", "CategoryType": 102, "IsHDBitrate": false, "ShowAIGC": true, "author": { "avatarLarger": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/18697e31f6f487f30f472dd4fd67ee6d~tplv-tiktokx-cropcenter:1080:1080.jpeg?...", "avatarMedium": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/18697e31f6f487f30f472dd4fd67ee6d~tplv-tiktokx-cropcenter:720:720.jpeg?...", "avatarThumb": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/18697e31f6f487f30f472dd4fd67ee6d~tplv-tiktokx-cropcenter:100:100.jpeg?...", "commentSetting": 0, "downloadSetting": 0, "duetSetting": 0, "ftc": false, "id": "97614653324771328", "isADVirtual": false, "isEmbedBanned": false, "nickname": "Selena Gomez", "openFavorite": false, "privateAccount": false, "relation": 0, "secUid": "MS4wLjABAAAATtFKZYaOb-9nF_w7QRi4y64d45mvuWuwf5ACEd3c6f-GTlfW9rJJlKfV2vWhg0aw", "secret": false, "shortDramaCreator": {}, "signature": "", "stitchSetting": 0, "uniqueId": "selenagomez", "verified": true }, "authorStats": { "diggCount": 3003, "followerCount": 58700000, "followingCount": 74, "friendCount": 0, "heart": 711400000, "heartCount": 711400000, "videoCount": 266 }, "authorStatsV2": { "diggCount": "3003", "followerCount": "58700000", "followingCount": "74", "friendCount": "0", "heart": "711400000", "heartCount": "711400000", "videoCount": "266" }, "backendSourceEventTracking": "", "collected": false, "contents": [ { "desc": "@Rare Beauty’s new foundation primes, covers, and sets all in ONE! It’s so easy to use and looks even better as the day goes on." } ], "createTime": 1775145751, "desc": "@Rare Beauty’s new foundation primes, covers, and sets all in ONE! It’s so easy to use and looks even better as the day goes on.", "digged": false, "diversificationId": 10026, "duetDisplay": 0, "duetEnabled": true, "forFriend": false, "id": "7624192891023297805", "isAd": false, "isReviewing": false, "itemCommentStatus": 0, "item_control": { "can_repost": true }, "music": { "authorName": "Emotional Lyrics💔", "duration": 48, "id": "7551651378742020886", "title": "original sound" }, "officalItem": false, "originalItem": false, "privateItem": false, "secret": false, "shareEnabled": true, "stats": { "collectCount": 14300, "commentCount": 10000, "diggCount": 577400, "playCount": 18100000, "shareCount": 7585 }, "statsV2": { "collectCount": "14251", "commentCount": "10000", "diggCount": "577400", "playCount": "18100000", "repostCount": "0", "shareCount": "7585" }, "stitchDisplay": 0, "stitchEnabled": true, "textExtra": [ { "type": 0, "userUniqueId": "rarebeauty" } ], "textLanguage": "en", "textTranslatable": true, "video": { "definition": "720p", "duration": 20, "format": "mp4", "height": 1280, "id": "7624192891023297805", "playAddr": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oEMghEc9P7BCAQikiLWItOb64EBaBUT8yFGMZ/?...", "ratio": "720p", "size": 2521755, "videoID": "v12044gd0000d779617og65tmmokn160", "videoQuality": "normal", "width": 720 }, "profile_username": "selenagomez", "profile": { "id": "97614653324771328", "uniqueId": "selenagomez", "nickname": "Selena Gomez", "verified": true } } ```` ### How It Works 1. You enter one or more TikTok usernames you want to check. 2. The actor looks up each profile and resolves the account details behind the username. 3. It then collects the most recent posts for that profile and keeps going until it reaches your chosen limit. 4. The actor returns the profile information and post data together in one organized result. 5. You can review, filter, and export the results for reporting, research, or outreach. ### Getting Started Getting started is simple: click **Try for free**, paste in one or more TikTok usernames, choose how many recent posts you want, and click **Run**. No coding is required, and the actor does the rest automatically. When the run finishes, you can download the results in **JSON, CSV, or Excel** depending on how you want to review or share the data. This makes it easy to move from TikTok research to analysis in just a few minutes. ### Frequently Asked Questions #### Do I need technical skills? No. This actor is designed for non-technical users. You only need to enter TikTok usernames and choose how many posts you want to collect. #### How fast does it run? Speed depends on how many usernames you enter and how many posts you request for each one. Smaller runs finish quickly, while larger collections take longer because the actor keeps gathering more recent posts until it reaches your limit. #### What format is the output? You can export the results in JSON, CSV, or Excel. That makes it easy to open the data in spreadsheets, share it with teammates, or connect it to your reporting workflow. #### Is this legal to use? This actor is intended for collecting publicly available profile and post information. You should always use the data responsibly and make sure your use complies with applicable laws, platform rules, and your own internal policies. #### Can I schedule it to run automatically? Yes, you can schedule runs so the actor checks usernames on a regular basis. This is useful for ongoing competitor tracking, creator monitoring, and content research. # Actor input Schema ## `usernames` (type: `array`): Enter one or more TikTok usernames to look up. The actor will fetch profile info and recent posts for each username. ## `max_results` (type: `integer`): Limit how many recent posts to collect for each username. The default is 100. ## Actor input object example ```json { "usernames": [ "selenagomez" ], "max_results": 10 } ``` # 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 = { "usernames": [ "selenagomez" ], "max_results": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("datamagnet/tiktok-profile-info-and-posts").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 = { "usernames": ["selenagomez"], "max_results": 10, } # Run the Actor and wait for it to finish run = client.actor("datamagnet/tiktok-profile-info-and-posts").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 '{ "usernames": [ "selenagomez" ], "max_results": 10 }' | apify call datamagnet/tiktok-profile-info-and-posts --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=datamagnet/tiktok-profile-info-and-posts", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "✅ TikTok User Posts Scraper", "description": "Get TikTok profile details and recent posts for one or more usernames in a simple run. Enter public usernames, and the actor returns profile info plus recent TikTok posts exactly as provided by the source, helping you research creators, competitors, and content fast.", "version": "0.0", "x-build-id": "qNpcFvJxkubb4nbv3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datamagnet~tiktok-profile-info-and-posts/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datamagnet-tiktok-profile-info-and-posts", "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/datamagnet~tiktok-profile-info-and-posts/runs": { "post": { "operationId": "runs-sync-datamagnet-tiktok-profile-info-and-posts", "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/datamagnet~tiktok-profile-info-and-posts/run-sync": { "post": { "operationId": "run-sync-datamagnet-tiktok-profile-info-and-posts", "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": [ "usernames" ], "properties": { "usernames": { "title": "Usernames", "type": "array", "description": "Enter one or more TikTok usernames to look up. The actor will fetch profile info and recent posts for each username.", "items": { "type": "string" } }, "max_results": { "title": "Maximum posts per user", "type": "integer", "description": "Limit how many recent posts to collect for each username. The default is 100." } } }, "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 } } } } } } } } } } ```