Tiktok Video Extractor (Rich Metadata)

Overview

This actor performs a deep extraction of video metadata, engagement metrics, and creator information from TikTok and similar video platforms. The extraction pipeline prioritizes data integrity through structured validation layers and timestamp verification. All records include ISO 8601 temporal markers and normalized engagement metrics to ensure downstream analytical reliability. The output schema is designed for direct ingestion into data warehouses, CRM systems, and business intelligence platforms.

Data Dictionary

Field Name	Data Type	Definition
video_id	String	Unique internal identifier for the video record
title	String	Video title as displayed on the platform
external_id	String	Platform-specific external identifier for cross-reference tracking
scraped_at	String (ISO 8601)	UTC timestamp indicating when the data extraction occurred
duration_seconds	Integer	Total video length in seconds
language_code	String	ISO 639-1 two-letter language code of primary audio/caption content
is_verified	Boolean	Indicates whether the content creator account has platform verification status
view_count	Integer	Cumulative number of video views at time of extraction
metadata.resolution	String	Video resolution in width x height pixel format
metadata.codec	String	Video compression codec identifier
metadata.bitrate	String	Average bitrate of the video stream
metadata.frame_rate	Float	Frames per second of the video playback
creator.channel_id	String	Unique identifier for the content creator's channel
creator.username	String	Public display name of the content creator
creator.subscriber_count	Integer	Total number of subscribers/followers for the creator account
creator.verified_status	Boolean	Indicates whether the creator account has platform verification
engagement.likes	Integer	Total number of positive reactions (likes) on the video
engagement.dislikes	Integer	Total number of negative reactions (dislikes) on the video
engagement.comments	Integer	Total number of user comments on the video
engagement.shares	Integer	Total number of times the video has been shared
content_tags	Array[String]	Platform-assigned or creator-defined categorical tags
sentiment_score	Float	Normalized sentiment score ranging from -1.0 (negative) to 1.0 (positive)
monetization_status	Boolean	Indicates whether the video is eligible for or actively monetized
age_restricted	Boolean	Indicates whether the video has age-based viewing restrictions
last_updated	String (ISO 8601)	UTC timestamp of the most recent metadata update on the platform
region_availability	Array[String]	ISO 3166-1 alpha-2 country codes where the video is accessible

Sample Dataset

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

{
  "video_id": "v8x2p9m4k5l",
  "title": "How to analyze big data patterns",
  "external_id": "VID_2025121915_8a7b6c5d4e3f",
  "scraped_at": "2025-12-19T14:22:31Z",
  "duration_seconds": 842,
  "language_code": "en",
  "is_verified": true,
  "view_count": 145267,
  "metadata": {
    "resolution": "1920x1080",
    "codec": "h.264",
    "bitrate": "2500kbps",
    "frame_rate": 29.97
  },
  "creator": {
    "channel_id": "UC7xyz123abc",
    "username": "DataScienceHub",
    "subscriber_count": 528900,
    "verified_status": true
  },
  "engagement": {
    "likes": 12453,
    "dislikes": 234,
    "comments": 1893,
    "shares": 742
  },
  "content_tags": ["data science", "tutorial", "analytics"],
  "sentiment_score": 0.87,
  "monetization_status": true,
  "age_restricted": false,
  "last_updated": "2025-12-18T09:15:22Z",
  "region_availability": ["US", "UK", "EU", "CA", "AU"]
}

Configuration Parameters

To ensure optimal data depth, configure the following:

Parameter	JSON Field Name	Data Type	Description	Example
Search Keyword	keyword	String	Primary search term used to query and filter video content from the target platform	dogs

Analytical Use Cases

Competitive Intelligence: Track competitor content performance by monitoring engagement velocity, sentiment trends, and audience growth patterns across creator accounts within specific market verticals.

Lead Generation: Identify high-engagement creators and viral content within target industries to build prospecting lists based on subscriber counts, verification status, and content relevance scores.

Sentiment Analysis: Aggregate sentiment scores across content tags and time periods to measure brand perception, product reception, or topic-level audience sentiment at scale.

Content Strategy Optimization: Analyze correlations between video metadata (duration, resolution, posting time) and engagement metrics to inform content production decisions and publishing schedules.

Network Mapping: Construct creator influence graphs by tracking share patterns, cross-channel references, and collaborative content to identify key opinion leaders and community structures.

Longitudinal Studies: Monitor temporal changes in engagement metrics, subscriber growth, and content output frequency to detect trend shifts, seasonal patterns, and platform algorithm changes.

Technical Limitations

Important Considerations:

• Rate limiting applies at 100 requests per minute per IP address to maintain platform compliance and prevent service interruption.
• Historical data availability is limited to the most recent 90 days for non-verified accounts; verified accounts may have extended retention.
• Engagement metrics reflect point-in-time snapshots and may not capture real-time changes occurring during extraction windows.
• Sentiment scores are derived from title and tag analysis only; full comment sentiment analysis requires separate processing.
• Region availability data reflects platform-reported restrictions and may not account for VPN or proxy access patterns.
• Deleted or private videos will return null values for most fields except video_id and scraped_at.
• Dislikes may be unavailable on certain platforms that have deprecated public dislike counts.

---

Keywords & Tags: This specification supports video scraper, video scraping tool, youtube scraper, tiktok scraper, export video metadata, video data extractor, and video scraping api implementations for sales intelligence and competitive analysis workflows.