# FreshRetailNet-50K: Fresh Retail Demand with Stockout Annotations

## Facts

- Provider: Dingdong Inc.
- License: CC-BY-4.0 (https://huggingface.co/datasets/Dingdong-Inc/FreshRetailNet-50K)
- Size: 5 files
- Format: Parquet (in sampled files)
- Stored at: Hugging Face, https://huggingface.co/datasets/Dingdong-Inc/FreshRetailNet-50K
- Access: public, readable without an account
- Category: Machine Learning & AI
- Source: https://arxiv.org/abs/2505.16319
- Page: https://scigantic.com/archive/18a2fca8-23e8-5226-a98c-d021e8b29691
- Keywords: Machine Learning & AI, time series, benchmark, Parquet, Hugging Face

## About

FreshRetailNet-50K, described by its authors as the first large-scale benchmark for censored demand estimation in fresh retail. It contains 50,000 store-product time series covering 90 days of detailed hourly sales from 898 stores in 18 major cities and 865 perishable SKUs, with stockout event annotations; about 20% of the data are organically occurring stockouts, so observed sales understate true demand. Rows carry encoded city, store, management group, three-level category and product ids, the date, normalised daily sale amount, hourly sales and hourly stock status, and covariates: discount rate, holiday and activity flags, precipitation, average temperature, humidity and wind level. Listing data/ (measured 2026-11-14) shows train.parquet (about 106 MB) and eval.parquet (about 8 MB). Uses include latent demand recovery under stockouts, demand forecasting for perishable goods, inventory and replenishment optimisation and time series imputation. Load with Hugging Face datasets or pandas; the GitHub repository has the baseline pipeline. Licensed CC BY 4.0 per the card; cite the FreshRetailNet-50K technical report.

## Load the data

```python
from datasets import load_dataset
ds = load_dataset("Dingdong-Inc/FreshRetailNet-50K")
print(ds)
```

## Data structure

File types in sampled files: Parquet

Example file: `data/eval.parquet`

## Open it

- In a hosted notebook with the data mounted: https://scigantic.com/archive/18a2fca8-23e8-5226-a98c-d021e8b29691
- Full record as JSON (schema card included): https://api.scigantic.com/api/archives/18a2fca8-23e8-5226-a98c-d021e8b29691
- Over MCP: `get_schema_card` with id `18a2fca8-23e8-5226-a98c-d021e8b29691` at https://api.scigantic.com/mcp

## Related topics

- [Parquet datasets](https://scigantic.com/topics/parquet)
- [Benchmark datasets](https://scigantic.com/topics/benchmark)
- [Time series datasets](https://scigantic.com/topics/time-series)
- [Machine Learning & AI datasets](https://scigantic.com/topics/machine-learning-and-ai)
