# TikTok User Data Extractor (`sandaliaapps/tiktok-user-data-extractor`) Actor

⚡️ Extract thousands of TikTok profiles in minutes! 📈 Use a list of URLs to gather data such as follower count, following count, likes, bio, video count, and more. 💾 Export in JSON, CSV, Excel, or XML. 🚀 Automate your TikTok analysis!

- **URL**: https://apify.com/sandaliaapps/tiktok-user-data-extractor.md
- **Developed by:** [Sandalia Apps](https://apify.com/sandaliaapps) (community)
- **Categories:** Social media, Lead generation
- **Stats:** 280 total users, 3 monthly users, 100.0% runs succeeded, 8 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

$35.00/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## The Importance of TikTok User Profile Data

TikTok has rapidly emerged as one of the leading social media platforms, especially among younger audiences. With its unique algorithm and user engagement, TikTok offers businesses a powerful tool for marketing. One of the most valuable assets for marketers on TikTok is user profile data.

### 1. Understanding Audience Demographics

#### Target Audience Insights

TikTok profile data provides insights into the demographics of users, including age, gender, and location. This information is crucial for:

- **Tailoring Content:** Creating content that resonates with your target audience.
- **Market Segmentation:** Identifying different audience segments for targeted campaigns.

#### Engagement Patterns

Analyzing when your audience is most active can help in scheduling posts for maximum visibility.

### 2. Content Performance Analysis

#### Identifying Trends

Profile data allows marketers to analyze which types of content perform best. Key metrics include:

- **Likes and Shares:** Indicate what resonates with users.
- **Comments:** Provide qualitative feedback on content.

#### A/B Testing

Marketers can use profile data to conduct A/B tests, comparing different types of content to see what generates the most engagement.

### 3. Competitor Benchmarking

#### Understanding Competition

By analyzing competitor profiles, businesses can gain insights into their strategies, such as:

- **Content Style:** What type of videos are getting more engagement?
- **Hashtags Used:** Identifying successful hashtags for broader reach.

#### Industry Trends

Monitoring competitors helps identify emerging trends within specific industries, enabling businesses to stay ahead of the curve.

### 4. Influencer Collaboration

#### Finding the Right Influencers

TikTok profile data can aid in identifying potential influencers who align with your brand values and target audience. Look for:

- **Follower Count:** Indicates reach and potential impact.
- **Engagement Rates:** A higher engagement rate often signifies a more active and dedicated audience.

#### Campaign Performance

After collaborations, marketers can analyze the performance of influencer campaigns through engagement metrics, helping to assess ROI.

### 5. Creating Personalized Marketing Strategies

#### Audience Interests

Profile data provides insights into users’ interests and behaviors. This information can help in:

- **Personalization:** Crafting tailored messages and content for different audience segments.
- **Product Recommendations:** Suggesting products that align with user preferences.

#### Retargeting Campaigns

By understanding user behavior, marketers can create effective retargeting strategies that lead to higher conversion rates.

### 6. Leveraging User-Generated Content

#### Encouraging Engagement

Profile data can help identify loyal customers and brand advocates, encouraging them to create user-generated content that promotes your brand.

#### Showcasing Authenticity

User-generated content is often perceived as more authentic, enhancing brand credibility and fostering trust among potential customers.

### 7. All the Profile Fields Tiktok User Data Extractor Extract for you

#### 🌟 The Profile Info:

- **uniqueId:** The username of the TikTok account.
- **nickname:** The user's chosen display name. 🎨
- **avatarLarger/avatarMedium/avatarThumb:** Links to profile pics in various sizes. 🖼️
- **signature:** The all-important bio! 📝
- **verified:** Do they have that blue checkmark? ☑️
- **privateAccount:** Is the profile locked down? 🔐
- **followerCount:** How many fans do they have? 📈
- **followingCount:** How many people do they follow? 👥
- **heart/heartCount:** Total likes across their videos. ❤️
- **videoCount:** How many TikToks have they posted? 🎬

#### 🔍 And Other Detailed Info:

- **id:** TikTok's internal user ID.
- **shortId:** Sometimes they have a shorter ID too.
- **createTime:** When did they join TikTok? 📅 (given in Unix time format)
- **secUid:** A super-secret ID for extra security. 🕵️‍♂️
- **ftc:** Following those pesky FTC rules? 🤔 (rare)
- **relation:** Are you following them? (0 = no, 1 = yes)
- **openFavorite:** Can you see their liked videos?
- **commentSetting:** Who can leave comments on their posts? 💬
- **commerceUserInfo:** Are they selling stuff on TikTok? 💰
- **commerceUser:** Seller or not?
- **category:** What kind of products? 🛍️
- **categoryButton:** Button mystery... 🤔
- **duetSetting:** Duet with them? 🎤 (settings)
- **stitchSetting:** Stitch it up! 🪡 (settings)
- **secret:** A hidden account? 👻 (rare)
- **isADVirtual:** A bot made for ads? 🤖
- **roomId:** Live stream happening? 🔴 (empty if not)
- **uniqueIdModifyTime:** When did they last change their username?
- **ttSeller:** Part of the TikTok Seller program? 🤑
- **region:** Where in the world are they? 🌎 (country code)
- **downloadSetting:** Can people download their videos? 📥
- **profileTab:** What tabs are visible on their profile?
- **showMusicTab:** Music? 🎶
- **showQuestionTab:** Q\&A? ❓
- **showPlayListTab:** Playlists? 🎧
- **followingVisibility:** Can you see their followers? (1 = yes, 0 = no)
- **recommendReason:** Why is TikTok suggesting this profile? (often empty)
- **nowInvitationCardUrl:** Inviting you to something? 🎉 (often empty)
- **nickNameModifyTime:** Last display name change.
- **isEmbedBanned:** Can you embed their profile?
- **canExpPlaylist:** Export those playlists?
- **profileEmbedPermission:** How much embedding is allowed?
- **language:** What language do they use on TikTok? 🗣️
- **eventList:** Got any events coming up? 🗓️ (usually empty)
- **suggestAccountBind:** Should they link other accounts?
- **isOrganization:** Is this a company account? 🏢
- **diggCount:** How many likes have they given out? 👍
- **friendCount:** Mutual friends on TikTok (if you're logged in). 🤝

### Output Example

```
[
  {
    "userInfo": {
      "user": {
        "id": "7045991194853590042",
        "shortId": "",
        "uniqueId": "tsports",
        "nickname": "T Sports",
        "avatarLarger": "https://p16-sign-useast2a.tiktokcdn.com/tos-useast2a-avt-0068-giso/46094aab6be2eb888418a04a2fafad7d~c5_1080x1080.jpeg?lk3s=a5d48078&nonce=17824&refresh_token=4f4c983bf16d0dcbb47097924e605c0a&x-expires=1728986400&x-signature=BKoiOeq9AEIhILBEe3CD2kn4cSo%3D&shp=a5d48078&shcp=81f88b70",
        "avatarMedium": "https://p16-sign-useast2a.tiktokcdn.com/tos-useast2a-avt-0068-giso/46094aab6be2eb888418a04a2fafad7d~c5_720x720.jpeg?lk3s=a5d48078&nonce=6965&refresh_token=cf65ccf34943b8de9d14a7cb23d542f5&x-expires=1728986400&x-signature=mN0hTdjghIcPXvQMBBWGh9yW2tI%3D&shp=a5d48078&shcp=81f88b70",
        "avatarThumb": "https://p16-sign-useast2a.tiktokcdn.com/tos-useast2a-avt-0068-giso/46094aab6be2eb888418a04a2fafad7d~c5_100x100.jpeg?lk3s=a5d48078&nonce=36899&refresh_token=b7eb52ab7e4dc4e2cdf40483c4074e44&x-expires=1728986400&x-signature=PmXiyJye1LmkDoJ%2F%2F%2BHKIEeGVOg%3D&shp=a5d48078&shcp=81f88b70",
        "signature": "Official TikTok account of first ever Bangladeshi Sports channel \"T Sports\".",
        "createTime": 1640523912,
        "verified": true,
        "secUid": "MS4wLjABAAAAtVJhIrheFohsPd2zTs1FpXZckxygH3oAdXcNmNB4BK8tpOOeIQergeC6hAOTO7Vs",
        "ftc": false,
        "relation": 0,
        "openFavorite": false,
        "bioLink": {
          "link": "www.tsports.com",
          "risk": 0
        },
        "commentSetting": 0,
        "commerceUserInfo": {
          "commerceUser": true,
          "category": "Sports, Fitness & Outdoors",
          "categoryButton": false
        },
        "duetSetting": 0,
        "stitchSetting": 0,
        "privateAccount": false,
        "secret": false,
        "isADVirtual": false,
        "roomId": "",
        "uniqueIdModifyTime": 0,
        "ttSeller": false,
        "region": "BD",
        "downloadSetting": 0,
        "profileTab": {
          "showMusicTab": false,
          "showQuestionTab": false,
          "showPlayListTab": true
        },
        "followingVisibility": 1,
        "recommendReason": "",
        "nowInvitationCardUrl": "",
        "nickNameModifyTime": 1640524002,
        "isEmbedBanned": false,
        "canExpPlaylist": true,
        "profileEmbedPermission": 1,
        "language": "en",
        "eventList": [],
        "suggestAccountBind": false,
        "isOrganization": 1
      },
      "stats": {
        "followerCount": 1000000,
        "followingCount": 0,
        "heart": 23200000,
        "heartCount": 23200000,
        "videoCount": 2325,
        "diggCount": 0,
        "friendCount": 0
      },
      "itemList": []
    },
    "shareMeta": {
      "title": "T Sports on TikTok",
      "desc": "@tsports 1.0m Followers, 0 Following, 23.2m Likes - Watch awesome short videos created by T Sports"
    },
    "statusCode": 0,
    "statusMsg": "ok",
    "needFix": false
  }
]
```

### Conclusion

TikTok profile data is an invaluable asset for marketers aiming to enhance their strategies on the platform. By leveraging audience insights, content performance metrics, and competitor analysis, businesses can create targeted and effective marketing campaigns. As TikTok continues to grow, harnessing profile data will be essential for staying competitive and reaching desired marketing goals.

#### Call to Action

Start analyzing TikTok profile data using this **TikTok User Data Extractor** today to unlock the potential of your marketing efforts or any other purpose!

# Actor input Schema

## `start_urls` (type: `array`):

URLs to start with

## `max_depth` (type: `integer`):

Depth to which to scrape to

## Actor input object example

```json
{
  "start_urls": [
    {
      "url": "https://www.tiktok.com/@tsports"
    }
  ],
  "max_depth": 1
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "start_urls": [
        {
            "url": "https://www.tiktok.com/@tsports"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("sandaliaapps/tiktok-user-data-extractor").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "start_urls": [{ "url": "https://www.tiktok.com/@tsports" }] }

# Run the Actor and wait for it to finish
run = client.actor("sandaliaapps/tiktok-user-data-extractor").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 '{
  "start_urls": [
    {
      "url": "https://www.tiktok.com/@tsports"
    }
  ]
}' |
apify call sandaliaapps/tiktok-user-data-extractor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=sandaliaapps/tiktok-user-data-extractor",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/5rfkRNWRcZZelNHNF/builds/LhGWSxciBBaeOhrN3/openapi.json