Catalog Price Change Summarizer

Analyze user-provided product or offer price records into grouped price intelligence. The Actor does not autonomously discover websites, scrape stores, use proxies, require logins, or call paid external APIs.

What It Does

It turns user-provided ecommerce price-list, offer, or competitor records into one grouped analysis row per comparable item. Use it when you already have price data and need deterministic spread, outlier, and action signals instead of manual spreadsheet cleanup.

Who It Is For

Pricing teams, ecommerce operators, resellers, and analysts comparing current listed prices across catalogs, merchants, regions, or channels.

Input

Provide records with product or item names, prices, optional currency, and optional source fields. Use groupKey, priceField, and dedupeKey to adapt the analysis to your own data.

Output

Each dataset row is one analyzed group with offer count, min/median/mean/max price, spread percentage, outlier count, deterministic score, recommended action, score explanation, and source record indexes.

How It Works

The Actor validates each record, normalizes the configured product and price fields, removes duplicates using group, currency, price, and source key, groups remaining offers by item, then calculates min, median, mean, max, spread percentage, and IQR outliers. The score ranges from 0 to 100: coverage adds confidence, wider spread increases review priority, and detected outliers reduce confidence. Recommended action is derived from the final score thresholds.

Example

{
  "records": [
    {"product": "Widget A", "price": "$10.00", "currency": "USD", "url": "https://a.example/w-a"},
    {"product": "Widget A", "price": 12, "currency": "USD", "url": "https://b.example/w-a"}
  ],
  "groupKey": "product",
  "priceField": "price",
  "dedupeKey": "url"
}

Pricing

PAY_PER_EVENT event analysis_record_emitted is charged once per emitted grouped analysis row. Invalid records, duplicates, skipped rows, and charge-limited records are not billable.

Limitations

Currency symbols and codes are normalized for grouping only; this Actor does not perform FX conversion.

Integration

Run it directly with JSON input, from an Apify task, or downstream from another Actor that produces a default dataset of price records. Results are written to the default dataset and the run summary is written to the OUTPUT key-value store record.

Differentiation

Use this for current ecommerce offer or price-list analysis. It is not a sold-comps tool: it does not require sale dates or distinguish completed sales from active listings.