Tiktok User Info Dataset (Full History)

Overview

This actor performs a deep extraction of TikTok user profile data, capturing comprehensive account metadata, engagement metrics, geographic information, and privacy configurations. The dataset provides high-fidelity snapshots of user profiles with structured regional data and temporal markers for longitudinal analysis. Data integrity is maintained through ISO 8601 timestamp standardization and validated geographic coordinates. The extraction pipeline ensures consistent schema adherence across all records, enabling reliable downstream analytics and CRM integration workflows.

Data Dictionary

Field Name	Data Type	Definition
user_id	String	Internal unique identifier assigned to the user account
external_id	String	External reference identifier for cross-platform data linkage
scraped_at	String (ISO 8601)	UTC timestamp indicating when the data extraction occurred
profile_created	String (ISO 8601)	UTC timestamp of the original account creation date
username	String	TikTok handle/username without @ prefix
display_name	String	User-defined public display name shown on profile
is_verified	Boolean	Indicates whether the account has official platform verification (blue checkmark)
language_code	String	ISO 639-1 language code with optional region (e.g., en-US)
account_type	String	Classification of account category (personal, business, creator)
status	String	Current account operational status (active, suspended, deleted)
location.region	String	Broad geographic region classification
location.country_code	String	ISO 3166-1 alpha-2 country code
location.timezone	String	IANA timezone identifier
location.lat	Float	Latitude coordinate in decimal degrees
location.lng	Float	Longitude coordinate in decimal degrees
engagement_metrics.followers_count	Integer	Total number of accounts following this user
engagement_metrics.following_count	Integer	Total number of accounts this user follows
engagement_metrics.total_posts	Integer	Cumulative count of published content items
engagement_metrics.avg_engagement_rate	Float	Mean engagement rate calculated as percentage
privacy_settings.profile_visible	Boolean	Indicates if profile is publicly accessible
privacy_settings.allow_messages	Boolean	Indicates if direct messaging is enabled
privacy_settings.show_activity	Boolean	Indicates if activity status is visible to others
last_active	String (ISO 8601)	UTC timestamp of most recent account activity
account_health_score	Float	Normalized score (0-1) indicating account quality and authenticity
verification_level	Integer	Tiered verification status (0=none, 1-5=increasing verification)
subscription_tier	String	Current subscription plan level (free, premium, enterprise)
data_retention_days	Integer	Number of days historical data is retained in the dataset

Sample Dataset

Below is a sample of the high-fidelity JSON output:

{
  "user_id": "usr_8f4e29a1b5c3",
  "external_id": "xid_7d9f3e2a1b5c8d4f6",
  "scraped_at": "2025-12-19T12:00:00Z",
  "profile_created": "2024-03-15T08:22:31Z",
  "username": "alex_smith_92",
  "display_name": "Alex Smith",
  "is_verified": true,
  "language_code": "en-US",
  "account_type": "personal",
  "status": "active",
  "location": {
    "region": "North America",
    "country_code": "US",
    "timezone": "America/New_York",
    "lat": 40.7128,
    "lng": -74.0060
  },
  "engagement_metrics": {
    "followers_count": 1234,
    "following_count": 891,
    "total_posts": 342,
    "avg_engagement_rate": 3.2
  },
  "privacy_settings": {
    "profile_visible": true,
    "allow_messages": true,
    "show_activity": false
  },
  "last_active": "2025-12-18T23:15:42Z",
  "account_health_score": 0.95,
  "verification_level": 3,
  "subscription_tier": "premium",
  "data_retention_days": 90
}

Configuration Parameters

To ensure optimal data depth, configure the following:

Parameter	Field Name	Data Type	Required	Example	Description
TikTok Username	username	String	Yes	"khaby.lame"	Unique TikTok handle without @ symbol; serves as primary lookup key for profile extraction

Analytical Use Cases

This dataset enables multiple research and business intelligence applications:

• Lead Enrichment & Segmentation: Sales intelligence teams can augment CRM records with verified geographic, engagement, and account metadata to build targeted prospect lists and personalize outreach campaigns based on region, verification status, and engagement patterns.

• Market Penetration Analysis: Researchers can aggregate regional distribution data to identify geographic concentration of user bases, enabling market entry strategies and localized content planning.

• Influencer Identification: Marketing analysts can filter by verification level, follower counts, and engagement rates to identify high-value creator partnerships and brand ambassador candidates.

• Longitudinal Cohort Studies: Data scientists can track account evolution over time using profile_created and scraped_at timestamps to analyze growth trajectories, retention patterns, and platform adoption curves.

• Network Mapping & Graph Analysis: The follower/following metrics enable construction of social graphs for community detection, influence propagation modeling, and network centrality calculations.

• Account Health Monitoring: Quality assurance teams can leverage account_health_score and verification_level to detect anomalous accounts, bot networks, or fraudulent profiles in datasets.

Technical Limitations

Important Considerations:

• Rate Limiting: Extraction throughput is subject to platform-imposed rate limits; bulk operations may require throttling to 100-200 requests per hour to avoid temporary access restrictions.

• Data Freshness: The scraped_at timestamp reflects point-in-time capture; engagement metrics and follower counts are volatile and may change rapidly between extraction runs.

• Geographic Precision: Location data accuracy depends on user-provided information and IP geolocation inference; lat/lng coordinates may represent city-level rather than precise locations.

• Privacy Compliance: Extraction is limited to publicly accessible profile data; accounts with profile_visible: false will return incomplete records or null values for restricted fields.

• Data Retention: Historical records are maintained for the duration specified in data_retention_days (default: 90 days); older snapshots are automatically purged from the dataset.

• Schema Stability: Field availability may vary based on account_type and privacy_settings; downstream pipelines should implement null-handling logic for optional fields.

• Username Volatility: TikTok usernames can be changed by users; user_id should be used as the stable primary key for record linkage across temporal datasets.

---

Keywords & Tags: web scraping tool, instagram scraper, user data scraper, export followers, profile scraper, region data extraction, lead generation