# Changelog of Pinterest Scraper — Pins, Boards, Profiles & Engagement (`blackfalcondata/pinterest-scraper`) Actor

- **URL**: https://apify.com/blackfalcondata/pinterest-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/blackfalcondata/pinterest-scraper.md

## Changelog

All notable changes to this actor are documented here.

### 0.1.6 — 2026-07-10

- New optional `includeEngagement`: add per-pin engagement metrics — saves, repins,
  shares, comment count, and reaction count — plus a fuller description. Off by
  default; enabling it fetches extra detail per pin, so runs take a little longer.
- Every pin now includes a `hashtags` array parsed from its text (empty when none).
- New `flattenedOutput`: flatten the nested `pin` / `board` / `profile` object into
  top-level fields for a single flat row per record — handy for spreadsheets and BI.
- New `profileOnly`: for profile or board Start URLs, return just the profile/board
  record and skip the pins beneath it when you only need the account/board metadata.

### 0.1.5 — 2026-07-10

- Two new incremental options: `emitUnchanged` also returns records that are
  unchanged since the last run (labeled UNCHANGED), and `emitExpired` returns
  records that were seen before but are now gone (labeled EXPIRED). Both are off
  by default, so a normal run still returns only new and updated records.
- `descriptionFormat` now offers two clear choices — keep the description as-is,
  or normalize it to plain text — and always preserves the full text.
- More reliable delivery against your Max Results: non-content grid rows no longer
  count toward the limit, so result-heavy searches return the volume you asked for.
- Sturdier runs: partial results are kept when a single request hiccups, transient
  empty responses are retried, and enrichment is time-bounded so one slow record
  can't stall the run.
- Clearer messages for unsupported inputs — e.g. a `pin.it/…` short link now tells
  you to paste the full `pinterest.com/pin/…` address instead of being skipped silently.
- Content-category confidence is now better calibrated for thin text.

### 0.1.4 — 2026-07-10

- New optional enrichment: turn on `includeSentiment` to add a `sentiment` object
  (label, score, confidence) and `includeContentCategory` to add a `contentCategory`
  object (label, confidence) on every record. Both are keyword-based, opt-in, and
  included at no extra charge — populated when enabled, `null` otherwise.

### 0.1.0 — 2026-07-10

Initial release.

- Search Pinterest by keyword or Start URL and export pins, boards, and profiles as one structured JSON envelope (`type` = `pin` | `board` | `profile`).
- Per-record media, outbound links, board and profile metadata, and derived canonical URLs.
- Optional detail enrichment, compact output, and description-length control.
- Incremental mode: only new or updated records are emitted across scheduled runs.
- Delivery to Telegram, Discord, Slack, WhatsApp, or a custom webhook.