H Mart Asian Grocery Scraper

Extract product data from H Mart (hmart.com) - the largest Asian American supermarket chain with 97+ locations.

Features

• JSON-LD Extraction: Prioritizes structured data for accurate pricing and product info
• Category Scraping: Access 90+ product categories
• Weekly Sales: Extract current sale items and prices
• No Bot Protection: Uses efficient CheerioCrawler (no browser needed)

Data Extracted

Field	Description
sku	Product SKU
mpn	Manufacturer part number
name	Product name
brand	Brand name
price	Current price (numeric)
priceFormatted	Price as string ($X.XX)
originalPrice	Original price if on sale
onSale	Boolean - is item on sale
discount	Discount percentage
availability	Stock status (InStock, OutOfStock)
priceValidUntil	Sale price expiration date
imageUrl	Product image URL
url	Product page URL
category	Category scraped from

Input Options

{
    "scrapeMode": "products",
    "categories": ["kimchi", "ramen", "snacks"],
    "maxProducts": 100
}

Scrape Modes

• products - Scrape products from selected categories
• weekly-sale - Get current sale items
• stores - Store location info
• all - Everything

Available Categories

• Korean: kimchi, gochujang, soybean-paste, rice, ramen
• Japanese: soy-sauce, frozen-noodles, seaweed
• Chinese: cooking-oil, dried-produce
• Proteins: beef, pork, chicken, marinated-meat, frozen-seafood
• Produce: fruit, vegetable
• Beverages: tea, coffee, soy-milk, juice
• Snacks: snacks, candy, ice-cream
• Instant: instant-rice, instant-soup, tteokbokki
• Dairy: dairy, egg
• Beauty: skincare, makeup, supplements

Technical Details

Data Source

H Mart uses VTEX e-commerce platform with excellent JSON-LD structured data:

• ItemList schema on category pages with nested Product items
• Full pricing via AggregateOffer schema
• Includes priceValidUntil for sale expiration

Selectors Reference

JSON-LD (Primary)

$('script[type="application/ld+json"]')
// Contains ItemList with Product items

DOM Fallback

// Product cards
$('[class*="product"], article')

// Product links
$('a[href*="/p"]')

// Prices
$('[class*="price"], [class*="Price"]')

// Images
$('img')

URL Patterns

• Homepage: https://www.hmart.com
• Category: https://www.hmart.com/{category-slug}
• Product: https://www.hmart.com/{product-slug}/p
• Weekly Ads: https://www.hmart.com/weekly-ads (dynamic)
• Stores: https://www.hmart.com/stores (dynamic)

Sitemap

• Categories: https://www.hmart.com/sitemap/category-0.xml
• Products: https://www.hmart.com/sitemap/product-0.xml, product-1.xml

Example Output

{
    "sku": "2672",
    "mpn": "2312403069",
    "name": "Cut Cabbage Kimchi (Mat Kimchi) 17.6oz(500g)",
    "brand": "Jongga",
    "url": "https://www.hmart.com/cut-cabbage-kimchi--mat-kimchi--17-6oz-500g-/p",
    "price": 5.99,
    "priceFormatted": "$5.99",
    "originalPrice": null,
    "onSale": false,
    "availability": "InStock",
    "priceValidUntil": "2026-01-30T04:00:00Z",
    "imageUrl": "https://hmartus.vtexassets.com/arquivos/ids/160334/_-500.png",
    "category": "sale",
    "source": "hmart.com",
    "scrapedAt": "2026-01-28T20:00:00.000Z"
}

Rate Limiting

No significant bot protection detected. Datacenter proxies work fine.

Notes

• Weekly ads are region-specific and require JavaScript rendering
• Store locations also require JavaScript (use Playwright scraper if needed)
• Product prices may vary by location