TikTok Chronology Analyzer
Pricing
Pay per usage
TikTok Chronology Analyzer
Takes TikTok video IDs as input and outputs ⏱️ timestamps, machine IDs, and sequence numbers. Perfect for analyzing posting patterns or building timeline-based content analytics. NO Scraping! NO Proxies! Purely "Scientific" 😊
Pricing
Pay per usage
Rating
5.0
(1)
Developer
Badruddeen Naseem
Actor stats
1
Bookmarked
2
Total users
1
Monthly active users
6 days ago
Last modified
Categories
Share
TikTok Video Timestamp Decoder
This Apify Actor decodes TikTok video IDs or full video URLs to reveal the original upload timestamps in UTC.
It handles multiple video IDs, supports old short TikTok IDs, and ensures a safe run even if no video IDs are provided.
Features
- Decode TikTok video IDs or full TikTok URLs.
- Supports multiple video IDs in a single run.
- Supports short historical TikTok IDs (6+ digits). Note: Short or historical IDs may not produce a valid timestamp and will return an error.
- Automatically removes leading
@from usernames. - Pushes a single nil row if no video IDs are provided.
- Safe Mode ensures a default test video ID is used to avoid failures during testing.
- Safe Mode enabled by default to prevent failed test runs.
Input Schema
| Field | Type | Description |
|---|---|---|
username | string | TikTok username (without @). If left blank, a default tiktokusername is used. |
videoIds | array | TikTok video IDs or full URLs. Leave blank for a nil result row. Supports multiple IDs. |
safeMode | boolean | WDefaults to true. When enabled, uses a default test video ID if none are provided. Set to false to disable. |
Example Input (Multiple Video IDs / URLs):
Output
The actor pushes the following fields to the dataset for each video:
| Field | Description |
|---|---|
videoId | Numeric TikTok video ID. |
decodedTimestamp | Full UTC ISO timestamp of upload. |
decodedDate | Upload date (YYYY-MM-DD). |
decodedTime | Upload time (HH:mm:ss). |
sequenceNumber | TikTok internal sequence number. |
machineId | TikTok internal machine/shard ID. |
originalUrl | Original URL, or "No video ID or URL provided" if input was empty. |
error | Error message if the video ID is invalid. |
Example Output Row:
Nil row if no video IDs provided:
How to Use
- Enter the TikTok username (with or without
@). - Enter video IDs or full URLs in the editor. Each entry should be on a separate line or array element.
- Enable or disable Safe Mode depending on whether you want the actor to automatically insert a test ID.
- Run the actor. The dataset will contain the decoded timestamps for each video.
Notes
- The actor automatically extracts numeric IDs from full TikTok URLs.
- Short historical IDs (e.g., 506804) can be entered, but the decoded timestamp may not reflect the actual original upload date.
- Leading
@in usernames is stripped automatically. - If you leave
videoIdsblank, the actor finishes successfully and pushes a single nil row. - Safe Mode ensures testing runs don’t fail by providing a default video ID.
