# Changelog of TikTok Metrics Scraper - Video & Profile Stats (`chronometrica/tiktok-metrics-scraper`) Actor

- **URL**: https://apify.com/chronometrica/tiktok-metrics-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/chronometrica/tiktok-metrics-scraper.md

## Changelog

### 0.1.10

- Improved metric matching for direct TikTok video URLs so public counts are
  tied more reliably to the requested video.

### 0.1.9

- Switched the public quick-start example and Console prefill to a MrBeast
  TikTok video while keeping the same buyer-facing input shape.

### 0.1.8

- Accepted raw dotted TikTok handles as profile inputs.
- Aligned the README quick-start example with the Actor example input and
  Console prefill.
- Added tests that keep the public quick-start sample and input prefill aligned.

### 0.1.7

- Simplified `postMetricStatus` and `profileMetricStatus` objects to include
  only `metric`, `status`, and `precision`.
- Kept metric counts in the top-level metric columns such as `views`, `likes`,
  `comments`, `shares`, `saves`, `reposts`, and profile metric count fields.
- Updated the dataset schema and output sample to match the cleaner metric
  status shape.

### 0.1.6

- Standardized public dataset column names for easier cross-platform reporting,
  including `postUrl`, `publishedAt`, `views`, `likes`, `comments`,
  `postMetricStatus`, and `profileMetricStatus`.
- Kept TikTok-specific public metrics that TikTok exposes, including `shares`,
  `saves`, `reposts`, `profileLikesCount`, and `profileVideosCount`.
- Removed non-essential technical fields from normal dataset rows.

### 0.1.5

- Added metric-by-metric status and precision details for post and profile
  metrics.
- Removed derived engagement-rate fields so exports stay focused on collected
  public metrics.
- Removed non-essential operational details from public dataset rows.
- Simplified the public dataset schema and default table view around core
  TikTok video, profile, metric, and status fields.

### 0.1.4

- Added one retry for transient public TikTok fetch failures.
- Improved handling for TikTok responses with partial public data availability.
- Improved status handling for successful direct video-page rows.

### 0.1.3

- Prefer full integer metric fields over compact TikTok display counts when both
  are exposed in public data.
- Mark metrics parsed from compact display values such as `1.2K` or `3.4M` as
  `display_rounded` instead of `exact`.
- Mark large bucketed public integers such as `17,900` or `1,500,000` as
  `likely_rounded` when they match TikTok-style display precision.
- Added metric precision details so users can distinguish exact, rounded, and
  unavailable counts.
- Kept normal output rows focused on stable public fields.

### 0.1.2

- Improved profile discovery for `@handle` inputs when TikTok exposes limited
  public profile data.
- Improved profile rows that include both public profile metrics and recent
  public video links.
- Improved handling for profiles with partial public data.

### 0.1.1

- Improved direct video metric extraction when TikTok exposes public video data.
- Preserved richer metric coverage when multiple public values are available.
- Improved collection of saves and repost counts when TikTok exposes them.

### 0.1.0

- Initial MVP for public TikTok video metric snapshots.
- Added direct video URL support for public TikTok metric snapshots.
- Added optional public profile discovery for recent video URLs.
- Added flat dataset rows with public video fields, profile fields, metrics,
  statuses, and run summary counters.