# ✅ TikTok User Posts Scraper (`datamagnet/tiktok-creator-profile-posts`) Actor Fetch a public TikTok creator’s profile info and posts from a username in one run. Enter a TikTok handle, set a post limit, and get the raw profile and post data exactly as returned by the source for research, tracking, or reporting. - **URL**: https://apify.com/datamagnet/tiktok-creator-profile-posts.md - **Developed by:** [Datamagnet](https://apify.com/datamagnet) (community) - **Categories:** Social media, Videos - **Stats:** 2 total users, 1 monthly users, 40.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 Scraper — TikTok User Posts Scraper & Data Collector TikTok Profile Scraper helps you quickly collect a public TikTok creator’s profile details and posts from a single username. It is ideal for marketers, researchers, agencies, and brands that need TikTok profile data, creator posts, and engagement stats in one place. Just enter a username, choose how many posts you want, and get the raw results exactly as returned by the source. If you need a simple TikTok scraper for creator research, content tracking, or competitive analysis, this actor is built for that workflow. ### Key Features - Extract a TikTok creator’s profile information from a username in one run. - Collect the creator’s posts with the full raw structure preserved. - Limit the number of posts returned so you only get the amount you need. - Capture profile stats such as followers, likes, following, and total videos. - Preserve post-level details including captions, hashtags, media links, music, and engagement counts. - Return share and visibility metadata that helps you understand how content is performing. - Keep the workflow simple for non-technical users who just want usable TikTok data. ### Use Cases #### Creator Research Marketing teams use this actor to review a TikTok creator’s profile data before outreach or collaboration. The returned fields such as nickname, verified status, follower count, bio link, and recent posts help teams judge audience fit and content style quickly. #### Competitive Analysis Brands and agencies can compare their own TikTok presence against competitors by collecting public creator posts and stats. Fields like play count, digg count, comment count, share count, and post captions make it easier to spot what content themes are getting traction. #### Influencer Vetting Influencer managers can check whether a creator looks authentic and active before starting a campaign. Profile fields like private account status, verification, follower count, and video count, combined with recent post content, help reduce bad partnerships and wasted spend. #### Content Inspiration Social media managers can study how successful creators write captions, use hashtags, and structure posts. The actor returns the raw post objects, including text, hashtags, music details, and media metadata, so teams can identify patterns worth adapting for their own content calendar. #### Audience and Brand Fit Review Agencies and brand teams can use the profile and post data to see whether a creator’s content aligns with a campaign. The combination of profile bio, linked website, post topics, and engagement stats gives a practical view of whether the creator matches the brand’s audience and message. #### Reporting and Archiving Analysts who need a record of public TikTok creator activity can save the returned data for reporting or internal archives. Because the actor keeps the source structure intact, it is useful when you want to preserve the original fields for later review or comparison. ### Input | Field | Type | Required | Description | Example | |---|---|---:|---|---| | count | integer | No | How many posts to return in one run. The actor will stop when it reaches this number or when there are no more posts. | 50 | | uniqueId | string | Yes | The TikTok username exactly as it appears on the profile, without the @ symbol. | taylorswift | | max_results | integer | No | The maximum number of results to collect overall. Use this when you want to cap the total amount of data returned. | 100 | ### Output | Field | Type | Description | |---|---|---| | AIGCDescription | string | A short description related to the post’s AI-generated content labeling, if available. | | CategoryType | integer | A category code that describes the type of post. | | IsHDBitrate | boolean | Shows whether the video is available in high bitrate quality. | | ShowAIGC | boolean | Indicates whether AI-related labeling should be shown for the post. | | author | object | Creator details attached to the post, including profile image, username, nickname, verification, and account settings. | | authorStats | object | Creator performance totals such as followers, likes, following, and total videos. | | authorStatsV2 | object | The same creator totals in string form for easier display or export. | | backendSourceEventTracking | string | Extra source tracking information returned with the post, if present. | | collected | boolean | Indicates whether the item was marked as collected by the source. | | contents | array | Caption fragments and tagged accounts or hashtags found in the post text. | | createTime | integer | The time the post was created, shown as a timestamp. | | desc | string | The full post caption or description. | | digged | boolean | Shows whether the item was liked by the source account or marked in a similar way. | | diversificationId | integer | A content classification or grouping value returned with the post. | | duetDisplay | integer | A display setting related to duet visibility. | | duetEnabled | boolean | Indicates whether duets are allowed for the post. | | forFriend | boolean | Shows whether the post is intended for friends only. | | id | string | The unique post identifier. | | isAd | boolean | Indicates whether the post is marked as an advertisement. | | isReviewing | boolean | Shows whether the post is under review. | | itemCommentStatus | integer | A status value related to comments on the post. | | item_control | object | Controls related to reposting and other post permissions. | | music | object | Music and audio details used in the post, including title, author, duration, and cover images. | | officalItem | boolean | Indicates whether the post is marked as official content. | | originalItem | boolean | Shows whether the post is marked as original content. | | privateItem | boolean | Indicates whether the post is private. | | secret | boolean | Indicates whether the post is hidden or restricted. | | shareEnabled | boolean | Shows whether the post can be shared. | | stats | object | Engagement totals such as likes, comments, shares, plays, and saves. | | statsV2 | object | The same engagement totals in string form for easier display or export. | | stitchDisplay | integer | A display setting related to stitch visibility. | | stitchEnabled | boolean | Indicates whether stitching is allowed for the post. | | textExtra | array | Tagged users and hashtags found in the caption text. | | textLanguage | string | The language detected for the caption. | | textTranslatable | boolean | Shows whether the caption can be translated. | | video | object | Video file details, including size, dimensions, cover images, and playback links. | | challenges | array | Hashtags or challenge tags attached to the post. | | user | object | Creator profile details returned with the post, including bio, links, and account settings. | ### 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?dr=14579&refresh_token=3d0180d6&x-expires=1784700000&x-signature=zhOsxpFEvHFaokl6mu6FiYFAXcA%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my2", "avatarMedium": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/18697e31f6f487f30f472dd4fd67ee6d~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=5a1d9a2c&x-expires=1784700000&x-signature=V1LwnXaI15wduq7tgDmo3k%2Fzqt4%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my2", "avatarThumb": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/18697e31f6f487f30f472dd4fd67ee6d~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=68c3a958&x-expires=1784700000&x-signature=OPTwWwgyhVsJjAuRNLRfu6jAnGs%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my2", "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": 14200, "commentCount": 10000, "diggCount": 576900, "playCount": 18100000, "shareCount": 7555 }, "statsV2": { "collectCount": "14223", "commentCount": "10000", "diggCount": "576900", "playCount": "18100000", "repostCount": "0", "shareCount": "7555" }, "stitchDisplay": 0, "stitchEnabled": true, "textExtra": [ { "secUid": "MS4wLjABAAAA6jD5EnBDk2ZvW7pbIS-Jug7NslGuR0RxmyKRdOZI3RfHKpHD4I9q4WXT9SISj2AI", "start": 0, "type": 0, "userUniqueId": "rarebeauty" } ], "textLanguage": "en", "textTranslatable": true, "video": { "definition": "720p", "duration": 20, "id": "7624192891023297805", "playAddr": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oEMghEc9P7BCAQikiLWItOb64EBaBUT8yFGMZ/...", "ratio": "720p", "size": 2521755, "width": 720 }, "user": { "id": "97614653324771328", "uniqueId": "selenagomez", "nickname": "Selena Gomez", "verified": true, "bioLink": { "link": "https://linktr.ee/selenagomez", "risk": 0 } } } ```` ### How It Works 1. You enter a TikTok username you want to research. 2. The actor finds the creator’s public profile and identifies the correct account. 3. It collects the creator’s posts and keeps going until it reaches your chosen limit or runs out of posts. 4. The results are returned in the same raw structure provided by the source, so you can review the full profile and post details. 5. You can then download, analyze, or archive the data for reporting, research, or campaign planning. ### Getting Started Getting started is simple and does not require coding knowledge. Click **Try for free**, enter the TikTok username, choose how many posts you want, and click **Run**. In a few moments, your results will be ready to review and download. You can export the output as JSON, CSV, or Excel depending on how you want to use the data. ### Frequently Asked Questions #### Do I need technical skills? No. This actor is designed for business users, marketers, and researchers who want TikTok profile and post data without dealing with complicated setup. You only need to enter a username and choose how many posts to collect. #### How fast does it run? Speed depends on the number of posts you request and how much public data is available for the account. Smaller requests usually finish quickly, while larger collections can take a bit longer because the actor keeps fetching more posts until it reaches your limit. #### What format is the output? The results are available in formats that are easy to work with, including JSON, CSV, and Excel. That makes it simple to review the data in a spreadsheet, share it with your team, or import it into your own reporting workflow. #### Is this legal to use? This actor is intended for collecting publicly available TikTok profile and post information. You should always make sure your use complies with applicable laws, TikTok’s terms, and your own internal policies, especially if you plan to store, analyze, or redistribute the data. #### Can I schedule it to run automatically? Yes, you can run it whenever you need fresh data, including on a recurring schedule if that fits your workflow. This is useful for tracking creator activity over time, monitoring engagement changes, or keeping an updated archive of public posts. # Actor input Schema ## `uniqueId` (type: `string`): The creator's TikTok username. ## `max_results` (type: `integer`): How many results to return overall. The default is 100. ## Actor input object example ```json { "uniqueId": "selenagomez", "max_results": 100 } ``` # 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 = { "uniqueId": "selenagomez", "max_results": 100 }; // Run the Actor and wait for it to finish const run = await client.actor("datamagnet/tiktok-creator-profile-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 = { "uniqueId": "selenagomez", "max_results": 100, } # Run the Actor and wait for it to finish run = client.actor("datamagnet/tiktok-creator-profile-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 '{ "uniqueId": "selenagomez", "max_results": 100 }' | apify call datamagnet/tiktok-creator-profile-posts --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=datamagnet/tiktok-creator-profile-posts", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "✅ TikTok User Posts Scraper", "description": "Fetch a public TikTok creator’s profile info and posts from a username in one run. Enter a TikTok handle, set a post limit, and get the raw profile and post data exactly as returned by the source for research, tracking, or reporting.", "version": "0.0", "x-build-id": "Ha4wH4aYSKJghgZDw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datamagnet~tiktok-creator-profile-posts/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datamagnet-tiktok-creator-profile-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-creator-profile-posts/runs": { "post": { "operationId": "runs-sync-datamagnet-tiktok-creator-profile-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-creator-profile-posts/run-sync": { "post": { "operationId": "run-sync-datamagnet-tiktok-creator-profile-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": [ "uniqueId" ], "properties": { "uniqueId": { "title": "Username", "type": "string", "description": "The creator's TikTok username." }, "max_results": { "title": "Maximum results", "type": "integer", "description": "How many results to return overall. 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 } } } } } } } } } } ```