# Changelog of Naver Shopping Scraper & Keyword Rank Tracker (네이버 쇼핑 순위) (`magenta_courser/naver-shopping-rank-tracker`) Actor

- **URL**: https://apify.com/magenta_courser/naver-shopping-rank-tracker/changelog.md
- **Full Actor documentation**: https://apify.com/magenta_courser/naver-shopping-rank-tracker.md

## Changelog

### 0.5.0

Additive release: everything new is off by default. With the same input as 0.4 the same requests are sent and the same product rows are saved and charged; `RUN_SUMMARY` only gains `extras` (null).

- **Extras for the top products of each search (optional inputs):** `extrasTopProducts` (default 10) chooses how many products per search get them; tracked products come first.
  - `includeSellerOffers`, `maxOffersPerProduct`: `sellerOffer` rows, the offers of a price-comparison catalog cheapest first (Naver stores only).
  - `includeReviewStats`: one `reviewStats` row per product with the 1 to 5 star counts, photo / video / after-a-month counts and reviewer answers.
  - `includeReviews`, `reviewSource` (STORE or CATALOG), `reviewSort`, `maxReviewsPerProduct`: `review` rows. Store reviews: the first 40 of an order. Catalog reviews: up to 500.
  - `includeQna`, `maxQnaPerProduct`: `qna` rows, public product questions with the seller's answers.
- Reviewer and asker names, IDs and profile images are never collected; mobile numbers and e-mail addresses in review and Q\&A text are masked.
- Extra rows use their own charge events (`seller-offer`, `review-stats`, `review`, `qna`). Rows of an event that has no price are saved without a charge.
- Extras run after all searches. A blocked extra never fails the run or changes the product rows; see `RUN_SUMMARY.extras` (rows per type, requests, blocked, status per product).
- Not available without a Naver login and therefore not offered: specification tables, offers of other malls, price history, AI review summary, a store's own product list.
- New dataset views for the four extra row types.

### 0.4.0

Additive release: no existing output field changes name, type, meaning or position; with the same input the same requests are sent and the same product rows are saved and charged.

- **Row filters (optional inputs):** `minPrice`, `maxPrice`, `filters` (free shipping, free returns, ships today, arrival guarantee, official store, brand store, rating 4.8+, in stock, overseas, used), `categoryIds`, `onlyStores`. Products that do not match are not saved and not charged; `rank` stays the real position in Naver's list. `RUN_SUMMARY.rowFilters` and `productsFilteredOut`.
- **Search links with filters:** new input `searchUrls`. The filter parameters of a Naver search link (brand, specs ...) are sent to Naver unchanged; such a search has its own rank history and its rows carry `searchFilters`. `keywords` may be empty when `searchUrls` is set.
- **Listing fields on product rows:** `rating6Months`, `standardProductName`, `isGroupProduct`, `optionNames`, `optionMinPrice`, `optionMaxPrice`, `saleType`, `isPreOrder`, `preOrderDeadlineDays`, `orderCutoffTime`, `isMembershipFreeDelivery`, `hasGift`, `isFreshProduct`, `storeMallId`, `mobileUrl`, `searchFilters`.
- Summary rows carry `searchFilters`; each `RUN_SUMMARY.searches` entry carries `searchFilters` and `productsFilteredOut`.
- New dataset view "Listing details".

### 0.3.0

Additive release: no existing output field changes name, type, meaning or position; the same requests are sent and the same product rows are saved and charged for the same input.

- **Alerts for tracked products:** `droppedOut` and `isRankDropAlert` on `myProductSummary` rows, `isRankDropAlert` on product rows, `RUN_SUMMARY.alerts[]` (`dropped_out`, `rank_drop`), new input `rankDropAlertThreshold` (default 10, 0 = off).
- **Fixed:** a tracked product entered as a Smart Store product number or URL kept `previousRank: null` once it left the scanned ranks. The rank history now also stores which product numbers belong to which Naver product ID. History saved by earlier versions is still read.
- **Catalog rival seller:** `catalogRivalType`, `catalogRivalPrice`, `catalogRivalShippingFee`, `catalogRivalStoreName`, `priceDiffVsCatalogRival`.
- **Promotions:** `promotionTypes`, `isSuperPoint`, `isLive`, `isSuperDeal`, `isSale`.
- **Catalog:** `catalogMatchStatus` (as reported by Naver), `catalogName`.
- **Category:** `categoryName`.
- **Unit price:** `unitQuantity`, `unitName`, `pricePerUnit`.
- **Store summary rows:** `productsInTop10`, `productsInTop40`, `productsInTop100`, `previousBestRank`, `bestRankChange`.
- New dataset view "Insights".
- `RUN_SUMMARY.historyAvailable`; a history store that cannot be opened is detected before it is opened, so the run finishes without comparison instead of waiting.

### 0.2.7

- The run continues without rank comparison when the history store cannot be opened.

### 0.2.6

- Falls back to the datacenter proxy when the residential proxy is not available; a fully blocked run ends with a clear message and no charge instead of failing.

### 0.2.5

- Price, stock and review-count changes; `outputMode: changesOnly`.

### 0.2.4

- Rank change since the last run: `previousRank`, `rankChange`, `isNewEntry`, `previousScrapedAt`.
