Yonghui Superstores Hypermarket Data API · Live

Pull live Yonghui data down to the cooperative farm, the transformed store.

Hypermarket product pricing, farm-cooperative sourcing detail, private-label vs. national-brand data, and "adjusted" transformed-store format tracking — 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 Yonghui verticals covered

<3s avg. response time

99.9% uptime SLA

14M+ requests / month served

GET /v1/yonghui/product

LIVE

// streaming a live product pull...

Why Choose Our Yonghui API

Two stores under the same name can carry very different assortments right now.

Yonghui has been actively converting standard hypermarkets into curated, quality-focused "adjusted" (调改) format stores with tighter SKU counts and upgraded fresh sections, while farm-cooperative sourcing feeds direct produce into both formats. Between that in-progress transformation, private-label SKUs sitting next to national brands, and hypermarket-scale assortment, Yonghui's catalog carries more format and sourcing detail than a standard supermarket 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 Yonghui changes its layout, we patch our parsers — your integration never breaks.

02

Store-format aware

Every response flags whether a listing comes from a standard hypermarket or a transformed "adjusted" format store.

03

Farm-cooperative sourcing detail

We resolve cooperative farm and origin data on eligible fresh-produce SKUs, plus private-label status across the catalog.

04

Built for scale from day one

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

Yonghui API Features

Everything you need to keep Yonghui 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, sourcing, store format — to cut payload size and parsing time.

🏪

Store-transformation resolution

Get standard vs. "adjusted" format status broken out per store, so you can compare assortment and pricing across formats.

🗂️

Bulk & scheduled requests

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

🌾

Farm-cooperative detection

Flag cooperative-sourced produce automatically on every eligible fresh 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 — sourcing and store-format detail included.

CoreSKU & product IDProduct name, category, unit type

PricingPrice & member priceCNY currency, price-per-unit

SourcingFarm cooperative / originDirect-source flag on eligible produce

StoreStore formatStandard hypermarket vs. "adjusted" store

BrandPrivate-label flagYonghui house brand vs. national brand

NutritionNutrition facts & allergensIngredients list, allergen warnings

MediaImagesProduct photos, packaging shots

ReviewsRatings & review countProduct rating, star breakdown

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

StructureCategory breadcrumbsFull category tree path

DeliveryYonghui Life delivery slotQuick-commerce minimum order & fee

TrustVerified listing flagConfirmed Yonghui SKU

Supported Yonghui Verticals

Fresh produce, private label, hypermarket grocery, and transformed stores — one integration covers all of it.

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

🥬

Fresh Produce & Farm Direct

Cooperative-sourced fruits & vegetables.

🏷️

Private Label & House Brand

Yonghui own-brand SKUs across categories.

🛒

Hypermarket Grocery

Full-format packaged grocery & household.

🏪

Transformed "Adjusted" Stores

Curated SKU assortment in renovated formats.

CoverageChina-wideHypermarket coverage across major provinces

Format调改 trackedStandard vs. transformed store format flagged per listing

FreshnessReal-timePrice and stock checked on every request

Yonghui API Endpoints

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

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

Live API Response Example

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

Popular Yonghui API Use Cases

Built for the teams that live and die by hypermarket data.

📈

Price & member savings monitoring

Feed live price and member pricing into your tracking tools every few minutes.

🌾

Farm-cooperative sourcing research

Analyze how much fresh produce carries direct-cooperative sourcing detail.

🏪

Store-transformation tracking

Compare SKU count, price, and assortment between standard and "adjusted" format stores.

🏷️

Private-label vs. national-brand comparison

Quantify the price gap between Yonghui house brand and equivalent national brands.

💬

Review & sentiment mining

Pull reviews across SKUs to power comparison and recommendation tools.

🤖

ML training data

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

🏆

Competitive benchmarking

Track how Yonghui pricing compares against Freshippo, RT-Mart, and Carrefour China.

⏱️

Quick-commerce delivery zone tracking

Monitor Yonghui Life delivery windows and fees across service areas.

How the Yonghui 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 /store depending on what you need.

3

Send the request

Call the endpoint with a SKU ID, keyword, or store ID 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.0%

Successful extraction rate

8K+

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 Yonghui 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. Price and stock are checked live on every request.

Yes. The /store endpoint returns a transformation-status field distinguishing standard hypermarkets from renovated "adjusted" format stores.

Yes — the /product endpoint returns cooperative farm and origin fields wherever Yonghui publishes that sourcing detail on a listing.

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