Shopee Seller Price & Stock Tracker

Turn Shopee product and seller snapshots into price, discount, stock, sell-through and competitive-position change intelligence across monitored markets. Returns structured, machine-readable results for repeatable research, monitoring, automation, Apify Tasks, API workflows, and AI.

Quick start

Start with this working example and replace the target values with your own:

{
  "currentItems": [
    {
      "id": "sku-a",
      "product": "Wireless Earbuds",
      "seller": "Alpha Store",
      "market": "BR",
      "price": 89.9,
      "stock": 42,
      "sold": 780,
      "discountPct": 25,
      "date": "2026-09-23"
    },
    {
      "id": "sku-b",
      "product": "Portable Blender",
      "seller": "Beta Shop",
      "market": "BR",
      "price": 119.0,
      "stock": 8,
      "sold": 430,
      "discountPct": 15,
      "date": "2026-09-23"
    },
    {
      "id": "sku-c",
      "product": "Gaming Mouse",
      "seller": "Gamma Tech",
      "market": "SG",
      "price": 31.5,
      "stock": 75,
      "sold": 920,
      "discountPct": 10,
      "date": "2026-09-23"
    }
  ],
  "previousItems": [
    {
      "id": "sku-a",
      "product": "Wireless Earbuds",
      "seller": "Alpha Store",
      "market": "BR",
      "price": 99.9,
      "stock": 70,
      "sold": 690,
      "discountPct": 18,
      "date": "2026-09-16"
    },
    {
      "id": "sku-b",
      "product": "Portable Blender",
      "seller": "Beta Shop",
      "market": "BR",
      "price": 119.0,
      "stock": 31,
      "sold": 390,
      "discountPct": 15,
      "date": "2026-09-16"
    }
  ],
  "maxItems": 20000
}

The Actor writes structured results to the default Apify Dataset and can be used from the Store, API, schedules, Tasks, automations and MCP-compatible AI workflows.

Input

• currentItems — Current records: Current source or normalized rows to analyze.
• currentDatasetId — Current Apify Dataset ID: Optional Apify Dataset ID used when currentItems is not supplied.
• previousDatasetId — Previous Apify Dataset ID: Optional previous Apify Dataset ID used instead of previousItems.
• maxItems — Maximum records: Maximum records loaded from a Dataset input.

All integration and advanced analysis fields are optional. The default example is intentionally runnable without configuring MCP or a previous-run baseline.

Output

The Dataset exposes predictable machine-readable output. Representative fields include results.

Pricing

This Actor uses Pay Per Event. The current factory base price is $0.004500 per result event. The Apify Store remains the source of truth for the price and plan/tier details shown to the buyer.

Use cases

• Run the buyer-ready workflows exposed as Apify Tasks without preparing a custom integration first.
• Use the Actor from API or schedules for recurring collection, comparison or monitoring.
• Feed the structured Dataset output into spreadsheets, databases, automations or AI agents.
• Compare repeat runs when the product supports snapshots or previous-run inputs.

Automation and AI

Use the same Actor through Apify API, schedules, public Tasks and the Apify MCP server. Outputs are structured for downstream workflows and AI agents rather than requiring manual copy/paste.

Limitations

• Public websites and upstream APIs can change markup, access rules, rate limits or field availability without notice.
• Fields that are not publicly available are returned as unavailable or omitted rather than fabricated.
• Analytical outputs depend on the quality and coverage of the supplied or collected source data.
• Treat marketplace, reputation, workforce, safety or commercial signals as decision support and validate material decisions against the underlying source evidence.

Detailed documentation

Detailed documentation

Turn Shopee product and seller snapshots into price, discount, stock, sell-through and competitive-position change intelligence across monitored markets.

Why use this Actor

Shopee teams can extract product rows easily, but recurring decisions require knowing which sellers cut price, lose stock, accelerate sales, or gain competitive position between snapshots. This Actor sits above raw extraction: supply a current dataset, optionally add a previous snapshot, and receive an aggregated report built for recurring monitoring and AI-agent workflows.

Key features

• Current-versus-previous snapshot comparison with deterministic deltas.

• Confidence-scored GO/WARN/BLOCK decision contract.

• Agent-ready recommended actions instead of raw rows.

• Dataset-ID inputs for recurring Apify workflows.

• Reads inline JSON rows or Apify Dataset IDs with limited READ permission.

• Writes one auditable report to the default Dataset and INTELLIGENCE_REPORT.

Example

Use the prefilled example or replace currentItems with rows from an upstream Actor. On recurring runs, provide the prior period in previousItems or previousDatasetId. The Actor normalizes common aliases, compares snapshots, ranks the strongest entity changes and emits agentAction.

Use cases

• Shopee competitor price and promotion monitoring.
• Stockout and sell-through signal detection.
• Seller assortment and market expansion analysis.
• AI-agent ecommerce monitoring workflows.

Pricing

One primary pay-per-event outcome: one decision-ready intelligence report. Base price USD 0.004 before Apify tier discounts. The 256 MB data-first architecture is designed for strong unit economics.

Limitations

• Analyzes supplied public or appropriately licensed data and does not bypass restricted sources.
• Scores are decision-support signals, not predictions or guarantees.
• Keep stable identifiers across snapshots for best change detection.
• Zero-direct-competition status is rechecked before publication because the Store changes continuously.

Workflow

upstream dataset -> current snapshot -> optional previous snapshot -> normalization -> entity aggregation -> change scoring -> ranked signals -> agentAction.

Output

The Actor writes one decision-ready record to the default Apify Dataset. The record includes marketSignalScore, executiveDecision, decisionConfidenceScore, recommendedAction, baseline availability, change counts, ranked topSignals, and optional economic-impact fields when the user supplies valuation inputs. This stable Gen2/Gen4 contract is designed for dashboards, automations and AI-agent workflows.