Freshippo New Retail Data API · Live

Pull live Freshippo data
down to the QR trace,
code,the 30-minute radius.

Real-time digital-tag pricing, full origin traceability via QR code, 30-minute delivery-zone detail, and live-seafood buy-to-cook service data — structured and delivered as clean JSON or CSV. No proxies to manage, no CAPTCHAs to solve, no HTML to parse.

See a Live Response

4 Freshippo verticals covered

<3s avg. response time

99.9% uptime SLA

18M+ requests / month served

GET /v1/freshippo/product

LIVE

// streaming a live product pull...

Why Choose Our Freshippo API

The store is the warehouse — the data model has to reflect that.

Freshippo stores double as fulfillment centers, promising delivery within 30 minutes inside a roughly 3km radius, with digital price tags that update in real time and QR codes tracing every fresh item back to its origin. Between that traceability layer, live-seafood buy-to-cook service, and a catalog spanning full-size Freshippo stores and smaller Freshippo Mini formats, this "new retail" model carries more structural detail than a standard grocery feed. Our infrastructure absorbs that complexity so your team just calls an endpoint and gets data back.

01

Zero blocking, zero maintenance

We run rotating residential IPs, headless rendering, and CAPTCHA-solving behind every request. When Freshippo changes its layout, we patch our parsers — your integration never breaks.

02

Real-time digital pricing aware

Every price response reflects the current digital-tag price, which can update multiple times a day.

03

Traceability & delivery-zone detail

We resolve QR-code origin data and 30-minute delivery-zone eligibility on every eligible listing, fields a standard grocery feed doesn't carry.

04

Built for scale from day one

From a 100-SKU test batch to millions of daily checks across store formats, the same endpoint and response shape scale with you.

Freshippo API Features

Everything you need to keep Freshippo data flowing.

⚡

Real-time extraction

Trigger an on-demand pull for any SKU, store, or keyword and get a fresh response — not a stale cache.

🧩

Custom field selection

Request only the fields you need — price, traceability, delivery zone — to cut payload size and parsing time.

📡

Digital price-tag resolution

Get the current live price reflected on Freshippo's digital shelf tags, updated as often as they change.

🗂️

Bulk & scheduled requests

Submit thousands of SKU IDs in one batch job or schedule recurring pulls on an hourly, daily, or custom cadence.

🔍

QR traceability detection

Flag origin, batch, and harvest-date data automatically on every eligible fresh-produce and seafood SKU.

📊

Historical price tracking

Store and query price and stock history per SKU to power repricing and trend-analysis tools.

What Data Can You Access?

Every field a product page shows — traceability and delivery-zone detail included.

CoreSKU & product IDProduct name, category, unit type

PricingReal-time digital priceCNY currency, price-per-unit

TraceabilityQR origin codeFarm, batch & harvest-date detail

Delivery30-minute zone eligibility3km radius delivery-zone flag

SeafoodLive-tank & buy-to-cook flagOn-site cooking service availability

StoreStore formatStandard Freshippo vs. Freshippo Mini

MediaImagesProduct photos, packaging shots

ReviewsRatings & review countProduct rating, star breakdown

StockAvailability statusIn-stock, low-stock, out-of-stock

StructureCategory breadcrumbsFull category tree path

NutritionNutrition facts & allergensIngredients list, allergen warnings

TrustVerified listing flagConfirmed Freshippo SKU

Supported Freshippo Verticals

Live seafood, farm-direct produce, food court, and grocery — one integration covers all of it.

Switch the vertical parameter to pull from a different Freshippo category with the same consistent response shape.

🦐

Live Seafood & Buy-to-Cook

Live tanks with on-site cooking service.

🥬

Fresh Produce & Farm Direct

Traceable fruits, vegetables & greens.

🍱

Ready Meals & Food Court

Prepared meals & in-store food court items.

🛒

Grocery & Household

Packaged grocery & household staples.

Delivery30-minute deliveryStore-as-warehouse fulfillment within a 3km radius

TraceabilityQR traceableOrigin and batch data tracked on eligible SKUs

FreshnessReal-timeDigital-tag price and stock checked on every request

Freshippo API Endpoints

A small set of endpoints that cover the whole catalog lifecycle.

Method	Endpoint	Description	Typical use
GET	/v1/freshippo/product	Full product detail by SKU ID or URL	Price & traceability monitoring
GET	/v1/freshippo/category	Category tree metadata & listing counts	Taxonomy mapping
GET	/v1/freshippo/search	Keyword, category, or district search results	Assortment & competitor discovery
GET	/v1/freshippo/reviews	Paginated customer reviews for a SKU	Sentiment analysis
GET	/v1/freshippo/stock	Real-time stock status by SKU and store	Availability tracking
POST	/v1/freshippo/bulk	Submit up to 10,000 SKU IDs per batch job	Catalog-wide monitoring
GET	/v1/freshippo/store	Store metadata & 30-minute delivery-zone boundaries	Footprint mapping

Live API Response Example

This is exactly what comes back. No extra parsing needed.

Popular Freshippo API Use Cases

Built for the teams that live and die by new-retail grocery data.

📈

Real-time digital price monitoring

Feed live digital-tag prices into your tracking tools as often as they change.

🔍

Traceability & origin auditing

Cross-check QR-code origin, batch, and harvest-date data against food-safety standards.

🗺️

30-minute delivery zone mapping

Map Freshippo's store-as-warehouse delivery radius across cities.

🦐

Buy-to-cook service tracking

Monitor which stores and SKUs offer live-seafood on-site cooking service.

💬

Review & sentiment mining

Pull reviews across SKUs to power comparison and recommendation tools.

🤖

ML training data

Generate labeled product, price, and traceability datasets for demand-forecasting models.

🏆

Competitive benchmarking

Track how Freshippo pricing compares against JD.com, Ele.me, and Meituan.

🏪

New-retail store format research

Study how Freshippo Mini assortment differs from full-size store formats.

How the Freshippo API Works

From API key to structured data in five steps.

1

Get your API key

Sign up and generate a key from your dashboard in under two minutes.

2

Choose an endpoint

Pick /product, /search, /reviews or /stock depending on what you need.

3

Send the request

Call the endpoint with a SKU ID, keyword, or district plus your vertical parameter.

4

We handle the hard part

Proxies, headless rendering, CAPTCHA-solving, and parsing all happen behind the scenes.

5

Receive structured data

Get clean JSON or CSV back in seconds, ready to drop into your pipeline.

Developer-Friendly Integration

Built by people who read the docs too.

One consistent JSON schema across every endpoint and every vertical. No SDK lock-in — plain REST calls work from any language or platform.

→

Predictable REST design

Standard HTTP verbs, query params, and status codes — nothing proprietary to learn.

→

JSON, CSV, or webhook delivery

Get results inline, as a downloadable file, or pushed to your endpoint when a batch job finishes.

→

Sandbox & test keys

Free sandbox environment with sample SKU IDs so you can build before you pay.

→

Postman collection & SDK snippets

Import a ready-made collection or copy request snippets for Python, Node.js, and cURL.

Quickstart

API Performance & Reliability

Numbers we publish because we track them daily.

99.9%

Uptime SLA

<3s

Avg. response time

99.1%

Successful extraction rate

9K+

Concurrent requests supported

Security & Compliance

Compliant by design, not as an afterthought.

🔒

Encrypted in transit

All requests and responses travel over TLS 1.2+. API keys can be scoped and rotated anytime.

⚖️

PIPL & global alignment

Our extraction workflows are built around China's Personal Information Protection Law alongside GDPR and CCPA guidelines.

🌐

Public-data-only policy

We collect only publicly accessible listing data — never login-gated or private account information.

✓ISO 9001:2015 Certified ✓ISO/IEC 27001:2013 Certified ✓IAF Multilateral Recognition ✓GDPR-aligned workflows

API Documentation & Resources

Everything to go from key to production.

Guide

Quickstart Guide

Get your first API response back in under five minutes.

Read guide →

Reference

Full API Reference

Every endpoint, parameter, and response field documented in detail.

View reference →

Tool

Postman Collection

Import ready-made requests for every Freshippo API endpoint.

Download →

Code

SDKs & Code Samples

Python, Node.js, PHP, and Ruby snippets for every use case.

Browse samples →

Frequently Asked Questions

Still deciding? Here's what most teams ask first.

We collect only publicly accessible listing data using automated tools, following publicly available web-data guidelines. We recommend reviewing your own use case with legal counsel, especially for redistribution.

Every request to /product, /search, and /stock triggers a live pull — you're not reading from a stale cache. Digital-tag pricing and stock are checked live on every request.

Yes — the /product endpoint returns origin, batch, and harvest-date fields wherever Freshippo publishes that traceability data on a listing.

Yes. The /store endpoint returns 30-minute delivery-zone boundaries per store, and product responses can be filtered by delivery-zone eligibility.

Our infrastructure retries automatically across a rotating proxy pool. You're only billed for successfully returned responses.

Yes, every account starts with a free sandbox key and sample credits so you can test all endpoints before committing to a plan.

By APIs

Ecommerce Scraping API

Food Scraping API

Grocery Scraping API

Travel Scraping API

Real Estate Scraping API

Quick Commerce Scraping API

Finance & Stock Scraping API

Social Media Scraping API

OTT Scraping API

Liquor Scraping API

Recruitment Scraping API

Healthcare Scraping API

Fashion Scraping API

Car Rental Scraping API

Solutions

Web Data

Solutions

Web Unlocker API

Anti Blocking

Live Crawler

Scraping Browser API

Lifestyle & Retail

Web Scraping Services

Web Scraping API Services

Mobile App Scraping services

Enterprise Web Crawling

Trending

Ecommerce

Grocery / Quick Commerce

Food

Travel

E-Commerce

Food

Grocery

Travel

Real-Estate

OTT

India

USA

UK

UAE

China

Looking for a Custom API?

India

USA

UK

UAE

China

Looking for a Custom API?

India

USA

UK

UAE

China

Looking for a Custom API?

India

USA

UK

UAE

China

Looking for a Custom API?

India

USA

UK

UAE

China

Looking for a Custom API?

India

USA

UK

UAE

China

Looking for a Custom API?

Use Cases (View More ⭢)

Price Comparison

Dynamic Pricing

Market Research

Robotic Process Automation (RPA)

Product Development

Pull live Freshippo data
down to the QR trace,
code,the 30-minute radius.