TikTok Users by Keywords Scraper

Overview

This Apify Actor scrapes TikTok user profiles based on search keywords. It returns detailed profile data for users matching your query, useful for lead generation, market research, or SEO analysis.

Key Features

• Searches TikTok users by keyword.
• Returns structured profile data including IDs, follower counts, and bios.
• Allows result filtering by region.
• Runs on the Apify platform with configurable input.

How to Use

1. Deploy the Actor on Apify.
2. Configure the input parameters (see Input section below).
3. Run the Actor.
4. Retrieve the scraped user profiles from the Actor's output dataset.

Input

Configure the Actor using a JSON input object with these parameters:

{
  "keywords": "nike",
  "size": 10,
  "regionCode": "US"
}

• keywords (Required): Search term to find users (e.g., "nike").
• size (Required): Number of user profiles to retrieve. Default is 10.
• regionCode (Optional): Two-letter region code to filter results (e.g., "US", "FR", "CA").

Output

The Actor outputs an array of user objects. Each object has this structure:

{
  "id": "123456789",
  "uniqueId": "example_user",
  "nickname": "Example User",
  "signature": "This is an example user.",
  "url": "https://www.tiktok.com/@example_user",
  "secUid": "MS4wLjABAAAA...",
  "followerCount": 1000,
  "avatarThumb": "https://example.com/avatar.jpg",
  "customVerify": "",
  "enterpriseVerifyReason": ""
}

Field Descriptions:
- id: The user's unique TikTok ID.
- uniqueId: The username (handle).
- nickname: The display name.
- signature: The user's bio/description.
- url: Direct link to the TikTok profile.
- secUid: A secure unique identifier.
- followerCount: Total number of followers.
- avatarThumb: URL to the profile picture.
- customVerify: Custom verification status.
- enterpriseVerifyReason: Reason provided for enterprise verification, if any.

Example

To get 5 users for the keyword "nike" in the US:
1. Set input to:

{
  "keywords": "nike",
  "size": 5,
  "regionCode": "US"
}

1. Run the Actor.
2. The dataset will contain the scraped profile data.