# ✅ TikTok User Reposts Scraper (`datamagnet/tiktok-profile-repost-data`) Actor Get repost data for one or more TikTok usernames in a simple, ready-to-use format. The actor looks up each profile, resolves the internal ID, and returns raw TikTok repost data, profile details, and item lists for easy review or reporting. - **URL**: https://apify.com/datamagnet/tiktok-profile-repost-data.md - **Developed by:** [Datamagnet](https://apify.com/datamagnet) (community) - **Categories:** Social media, 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 Repost Scraper TikTok Profile Repost Scraper helps you quickly collect repost data from one or more TikTok usernames in a simple, business-friendly way. Enter the usernames you want to check, and the actor looks up each TikTok profile, finds the internal profile identifier, and returns the repost-related data exactly as received. It is ideal for marketers, researchers, agencies, and social media teams who need TikTok profile repost data, profile lookup details, and repost item lists without manual copying. If you want a fast way to gather TikTok repost information for multiple accounts in one run, this actor is built for that. ### Key Features - Extract repost data for any TikTok username you provide. - Collect results for multiple TikTok profiles in a single run. - Return raw profile lookup and repost details exactly as received. - Capture useful profile information such as nickname, follower count, and verification status. - Include repost item details like captions, share metadata, stats, and media information. - Fetch more repost items automatically until the limit is reached or no more data is available. - Save time by turning a manual profile-checking task into a repeatable workflow. ### Use Cases #### Social Media Research Social media analysts use this actor to understand what a TikTok profile is reposting and how that content is presented. The output includes profile details, repost item lists, captions, and engagement stats, which makes it easier to compare accounts and spot patterns. This is useful when you want to study creator behavior, brand activity, or content themes across several usernames. #### Influencer and Creator Vetting Agencies and brands can review a creator’s repost activity before starting a partnership. The returned profile data, such as follower count, verification status, nickname, and bio link, helps teams confirm whether an account looks credible and relevant. Repost content and share metadata also give a clearer picture of what the creator amplifies on TikTok. #### Brand Monitoring Marketing teams can track how a brand account or public figure account behaves on TikTok by checking repost-related activity over time. The actor returns the raw repost response, including item stats, share counts, and content descriptions, so teams can review what is being shared and how it may support campaigns. This helps with brand safety checks, campaign analysis, and content review. #### Competitive Intelligence Businesses can compare multiple competitor usernames in one run to see how different TikTok profiles behave. Because the output includes user info, stats, and repost item lists, you can compare audience size, posting activity, and the type of content being reposted. That makes it easier to identify content strategies and benchmark accounts against each other. #### Content and Trend Analysis Researchers and content strategists can use the repost data to understand which topics, creators, or hashtags are being amplified. Fields like captions, text extras, challenges, and music details help reveal the context around each reposted item. This is valuable when you want to spot recurring themes, campaign messages, or trending content formats. #### Multi-Account Reporting Teams that manage several TikTok profiles can process a list of usernames in one go and build a simple report from the results. The actor returns the same structure for each profile, which makes it easier to compare accounts side by side. This is especially helpful for agencies, internal social teams, and researchers who need repeatable reporting. ### Input | Field | Type | Required | Description | Example | |---|---|---:|---|---| | Usernames | array | Yes | Enter one or more TikTok usernames to process. Use the username shown on the profile, without the @ symbol. | ["selenagomez", "taylorswift"] | | Max results | integer | No | Maximum number of repost items to collect per username. The actor keeps going until it reaches this limit or there is no more data. | 100 | ### Output | Field | Type | Description | |---|---|---| | AIGCDescription | string | A short automated description field returned by TikTok, if present. | | CategoryType | integer | A category code that helps identify the type of content. | | IsHDBitrate | boolean | Shows whether the video is available in high bitrate quality. | | ShowAIGC | boolean | Indicates whether AI-related content labeling is shown. | | adAuthorization | boolean | Tells you whether the item is allowed for ad-related use. | | anchors | array | Extra linked content or promotional elements attached to the item. | | author | object | Profile details for the account connected to the reposted item. | | authorStats | object | Main profile performance numbers such as followers and likes. | | authorStatsV2 | object | The same profile stats in text form. | | backendSourceEventTracking | string | Internal tracking information returned with the item. | | challenges | array | Hashtags or challenge tags connected to the content. | | collected | boolean | Shows whether the item was marked as collected. | | contents | array | Caption fragments and tagged mentions included in the post. | | createTime | integer | The time the item was created, shown as a timestamp. | | creatorAIComment | object | AI-related eligibility information for the item. | | desc | string | The full caption or description text for the reposted item. | | digged | boolean | Indicates whether the item was liked by the account. | | diversificationId | integer | A content classification identifier returned by TikTok. | | duetDisplay | integer | A display setting related to duet behavior. | | duetEnabled | boolean | Shows whether duet is enabled for the item. | | effectStickers | array | Sticker effects attached to the video. | | forFriend | boolean | Indicates whether the item is shared for friends. | | id | string | The unique ID of the reposted item. | | isAd | boolean | Shows whether the item is marked as an advertisement. | | isReviewing | boolean | Indicates whether the item is under review. | | itemCommentStatus | integer | A status code for comments on the item. | | item_control | object | Sharing, reposting, and comment permissions for the item. | | music | object | Music details attached to the item, including title and artist. | | officalItem | boolean | Indicates whether the item is an official post. | | originalItem | boolean | Shows whether the item is original content. | | playlistId | string | The playlist ID if the item belongs to a playlist. | | privateItem | boolean | Indicates whether the item is private. | | secret | boolean | Shows whether the item is hidden or restricted. | | shareEnabled | boolean | Tells you whether sharing is enabled. | | stats | object | Engagement numbers such as likes, comments, shares, and plays. | | statsV2 | object | The same engagement numbers in text form, including repost count. | | stitchDisplay | integer | A display setting related to stitch behavior. | | stitchEnabled | boolean | Shows whether stitch is enabled for the item. | | textExtra | array | Tagged users and hashtags found in the caption. | | textLanguage | string | The language detected in the caption text. | | textTranslatable | boolean | Indicates whether the caption can be translated. | | video | object | Video file details, preview links, and quality information. | | user | object | Profile lookup data, share text, and status information for the username. | ### Sample Output ```json { "AIGCDescription": "", "CategoryType": 102, "IsHDBitrate": false, "ShowAIGC": false, "adAuthorization": true, "author": { "id": "97614653324771328", "uniqueId": "selenagomez", "nickname": "Selena Gomez", "verified": true }, "authorStats": { "followerCount": 58700000, "followingCount": 74, "heart": 711400000, "videoCount": 266 }, "desc": "The newest member of the Soft Pinch family has arrived... Soft Pinch Lip Oil Stick is your favorite lip oil + gloss + lipstick all in one...", "id": "7659785653890125086", "isAd": true, "music": { "authorName": "Rare Beauty", "title": "original sound", "duration": 15 }, "shareEnabled": true, "stats": { "collectCount": 999, "commentCount": 177, "diggCount": 12200, "playCount": 147700, "shareCount": 922 }, "statsV2": { "collectCount": "999", "commentCount": "177", "diggCount": "12200", "playCount": "147700", "repostCount": "0", "shareCount": "922" }, "textLanguage": "en", "video": { "definition": "720p", "duration": 15, "width": 720, "height": 1280 }, "user": { "shareMeta": { "title": "Selena Gomez on TikTok", "desc": "@selenagomez 58.7m Followers, 74 Following, 711.4m Likes - Watch awesome short videos created by Selena Gomez" }, "statusCode": 0, "statusMsg": "", "needFix": false } } ```` ### How It Works 1. You enter one or more TikTok usernames you want to check. 2. The actor looks up each profile and finds the account details needed to continue. 3. It then gathers repost-related data for each resolved profile. 4. If you set a result limit, it keeps collecting items until it reaches that number or runs out of data. 5. You receive the results in a clean export you can review, save, or share. ### Getting Started Getting started is simple and does not require coding knowledge. Click **Try for free**, paste in one or more TikTok usernames, choose how many results you want per username, and click **Run**. The actor will do the rest automatically and return the results in a format you can work with right away. You can download the output as JSON, CSV, or Excel depending on how you want to review or share the data. ### Frequently Asked Questions #### Do I need technical skills? No. This actor is designed for business users, marketers, researchers, and agencies who want TikTok repost data without doing manual work. You only need to enter usernames and start the run. #### How fast does it run? Speed depends on how many usernames you enter and how many repost items you request for each one. Smaller runs usually finish quickly, while larger lists take longer because the actor collects more data for each profile. #### What format is the output? The results are available in easy-to-use export formats such as 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 workflow. #### Is this legal to use? This actor is intended for lawful research, analysis, and business use. You should always make sure your use of the data follows applicable laws, TikTok’s terms, and your organization’s policies. #### Can I schedule it to run automatically? Yes, you can run it whenever you need fresh data, and it can also be used in recurring workflows if you want regular updates. This is helpful for monitoring profiles over time, comparing accounts, or keeping reports current. # Actor input Schema ## `usernames` (type: `array`): Enter one or more TikTok usernames to look up. ## `max_results` (type: `integer`): The maximum number of repost results to return for each username. The default and maximum value is 10. ## 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-repost-data").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-repost-data").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-repost-data --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=datamagnet/tiktok-profile-repost-data", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "✅ TikTok User Reposts Scraper", "description": "Get repost data for one or more TikTok usernames in a simple, ready-to-use format. The actor looks up each profile, resolves the internal ID, and returns raw TikTok repost data, profile details, and item lists for easy review or reporting.", "version": "0.0", "x-build-id": "IcYznIQ9rzIPmict5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datamagnet~tiktok-profile-repost-data/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datamagnet-tiktok-profile-repost-data", "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-repost-data/runs": { "post": { "operationId": "runs-sync-datamagnet-tiktok-profile-repost-data", "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-repost-data/run-sync": { "post": { "operationId": "run-sync-datamagnet-tiktok-profile-repost-data", "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": "TikTok usernames", "type": "array", "description": "Enter one or more TikTok usernames to look up.", "items": { "type": "string" } }, "max_results": { "title": "Maximum results per username", "type": "integer", "description": "The maximum number of repost results to return for each username. The default and maximum value is 10." } } }, "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 } } } } } } } } } } ```