SSG.COM (쓱닷컴) API & Scraper
SSG.COM (쓱닷컴) is the online mall of Korea's Shinsegae and E-mart group: E-mart groceries delivered from a store (쓱배송), SSG early-morning delivery (새벽배송), E-mart Traders, Shinsegae Mall, the department store and marketplace sellers in one catalogue, priced in won.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
This API reads it as JSON. `search` returns 40 rows per page with the regular price, the discounted price, the unit price (for example 189 won per 100ml), the member benefit amount and card discount text, the stock count, the mall and who sells it, the delivering E-mart store, the delivery type and the arrival promise, and the rating and review count. Filters: mall, seven sorts, price range, delivery type, benefit, sold-out exclusion and category. `product` returns one item's live listing with its review summary, `reviews` returns 30 reviews per page with attribute answers such as taste, packaging and freshness, and `categories` returns the category tree with brands.
What an SSG.COM field actually contains
Fields that read differently from how they look. Every row was measured against live SSG.COM answers on 2026-10-18.
| Field | What it holds |
|---|---|
| price, discount_price | price is the regular price in won (the page's 판매가); discount_price is the price the page shows after the item's own discount, and is null when there is no discount. The shown price matched the item's own page on 12 of 12 items across six malls. |
| coupon_applied | true when SSG has already applied an automatic coupon to the shown price (쿠폰할인). |
| unit_price, unit | The site's own unit price and its unit, for example 189 per 100ml. Present on 224 of 320 search rows; goods without a unit price return null. |
| member_benefit_krw, card_discount_texts | Benefits printed next to the price: the 신세계 유니버스 club amount in won (132 on a 1,890 won milk) and card texts such as 3% 카드할인 or 청구할인. They are not folded into price. |
| store_no, store_name, store_defaulted | E-mart, Traders and early-morning goods are priced and stocked by one store or centre. Without a saved delivery address SSG uses its default store (E-mart 월계점 on 2026-10-18); those rows say store_defaulted true. Other stores need a member address and are not available. |
| stock_qty, early_morning_stock_qty | Stock count at the delivering store, and the stock of the same item for early-morning delivery. One milk had 44 at the E-mart store and 123 at the early-morning centre in the same minute. Some marketplace rows carry 99999, which is the source's own value. |
| mall, sold_by, vendor_id | mall is the SSG mall a row is listed in (emart, traders, early_morning, shinsegae, department …); sold_by is emart, traders, ssg (early-morning) or seller; vendor_id is SSG's supplier id. |
| rental, monthly_fee_text | Rental and subscription offers have no purchase price: price is null and the monthly fee text is returned instead. |
Prices are SSG.COM's prices in won and were identical from Korean and non-Korean networks (40 of 40 rows). Logged-out data only: no member-only prices and no choice of E-mart store.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/ssg/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "우유"
}
}{
"ok": true,
"meta": {
"api": "ssg",
"endpoint": "search",
"mode": "live",
"latency_ms": 2172.8,
"record_count": 40,
"bytes": 240709,
"cache_hit": false,
"upstream_requests": 2,
"charged_credits": 3,
"version": "1.0.0",
"request_id": "43e84e4ad83c4d35",
"queue_ms": 6.7,
"fetched_at": "2026-10-18T17:45:07.184Z"
},
"data": {
"query": "우유",
"sort": "recommended",
"page": 1,
"total": 162270,
"has_more": true,
"results": [
{
"item_id": "1000277628967",
"site_no": "6001",
"mall": "emart",
"mall_name": "이마트",
"title": "굿모닝 굿밀크 1L",
"full_title": "[노브랜드] 굿모닝 굿밀크 1L",
"brand": "노브랜드",
"url": "https://www.ssg.com/item/itemView.ssg?itemId=1000277628967&siteNo=6001&salestrNo=2037",
"image": "https://sitem.ssgcdn.com/67/89/62/item/1000277628967_i1_500.jpg",
"images": [
"https://sitem.ssgcdn.com/67/89/62/item/1000277628967_i1_500.jpg",
"https://sitem.ssgcdn.com/67/89/62/item/1000277628967_i2_500.jpg"
],
"price": 1890,
"discount_price": null,
"discount_percent": null,
"source_discount_rate": null,
"coupon_applied": false,
"price_from": false,
"currency": "KRW",
"unit_price": 189,
"unit": "100ml",
"member_benefit_krw": 132,
"card_discount_texts": [
"청구할인"
],
"multi_buy_texts": [],
"rental": false,
"monthly_fee_text": null,
"stock_qty": 62,
"sold_out": false,
"min_order_qty": 1,
"max_order_qty": 32,
"sold_by": "emart",
"vendor_id": "0023947149",
"store_no": "2037",
"store_name": "월계점",
"store_defaulted": true,
"delivery_types": [
"주간배송"
],
"delivery_promise": "오늘(월) 14:00까지 도착",
"shipping_text": "4만↑무료배송",
"early_morning_available": true,
"early_morning_stock_qty": 1668,
"rating": 4.8,
"review_count": 338950,
"badges": [
{
"type": "[trimmed-depth]",
"text": "[trimmed-depth]"
},
{
"type": "[trimmed-depth]",
"text": "[trimmed-depth]"
},
{
"type": "[trimmed-depth]",
"text": "[trimmed-depth]"
}
],
"ad_marked": false
},
{
"item_id": "0000006615474",
"site_no": "6001",
"mall": "emart",
"mall_name": "이마트",
"title": "1000ml 나100%",
"full_title": "[서울우유] 1000ml 나100%",
"brand": "서울우유",
"url": "https://www.ssg.com/item/itemView.ssg?itemId=0000006615474&siteNo=6001&salestrNo=2037",
"image": "https://sitem.ssgcdn.com/74/54/61/item/0000006615474_i1_500.jpg",
"images": [
"https://sitem.ssgcdn.com/74/54/61/item/0000006615474_i1_500.jpg",
"https://sitem.ssgcdn.com/74/54/61/item/0000006615474_i2_500.jpg"
],
"price": 2970,
"discount_price": null,
"discount_percent": null,
"source_discount_rate": null,
"coupon_applied": false,
"price_from": false,
"currency": "KRW",
"unit_price": 297,
"unit": "100ml",
"member_benefit_krw": 207,
"card_discount_texts": [
"3% 카드할인",
"청구할인"
],
"multi_buy_texts": [],
"rental": false,
"monthly_fee_text": null,
"stock_qty": 51,
"sold_out": false,
"min_order_qty": 1,
"max_order_qty": 15,
"sold_by": "emart",
"vendor_id": "0023947149",
"store_no": "2037",
"store_name": "월계점",
"store_defaulted": true,
"delivery_types": [
"주간배송"
],
"delivery_promise": "오늘(월) 14:00까지 도착",
"shipping_text": "4만↑무료배송",
"early_morning_available": false,
"early_morning_stock_qty": null,
"rating": 4.9,
"review_count": 366405,
"badges": [
{
"type": "[trimmed-depth]",
"text": "[trimmed-depth]"
},
{
"type": "[trimmed-depth]",
"text": "[trimmed-depth]"
},
{
"type": "[trimmed-depth]",
"text": "[trimmed-depth]"
}
],
"ad_marked": false
},
{
"item_id": "1000057388235",
"site_no": "6001",
"mall": "emart",
"mall_name": "이마트",
"title": "에이 클래스 우유 900ml (1A등급)",
"full_title": "[피코크] 에이 클래스 우유 900ml (1A등급)",
"brand": "피코크",
"url": "https://www.ssg.com/item/itemView.ssg?itemId=1000057388235&siteNo=6001&salestrNo=2037",
"image": "https://sitem.ssgcdn.com/35/82/38/item/1000057388235_i1_500.jpg",
"images": [
"https://sitem.ssgcdn.com/35/82/38/item/1000057388235_i1_500.jpg",
"https://sitem.ssgcdn.com/35/82/38/item/1000057388235_i2_500.jpg"
],
"price": 2480,
"discount_price": null,
"discount_percent": null,
"source_discount_rate": null,
"coupon_applied": false,
"price_from": false,
"currency": "KRW",
"unit_price": 276,
"unit": "100ml",
"member_benefit_krw": 173,
"card_discount_texts": [
"3% 카드할인",
"청구할인"
],
"multi_buy_texts": [],
"rental": false,
"monthly_fee_text": null,
"stock_qty": 0,
"sold_out": true,
"min_order_qty": 1,
"max_order_qty": 20,
"sold_by": "emart",
"vendor_id": "0023947149",
"store_no": "2037",
"store_name": "월계점",
"store_defaulted": true,
"delivery_types": [
"주간배송"
],
"delivery_promise": null,
"shipping_text": "4만↑무료배송",
"early_morning_available": false,
"early_morning_stock_qty": null,
"rating": 4.8,
"review_count": 202433,
"badges": [
{
"type": "[trimmed-depth]",
"text": "[trimmed-depth]"
},
{
"type": "[trimmed-depth]",
"text": "[trimmed-depth]"
},
{
"type": "[trimmed-depth]",
"text": "[trimmed-depth]"
}
],
"ad_marked": false
}
]
}
}What the SSG.COM (쓱닷컴) API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Keyword search on SSG.COM across E-mart, Traders, early-morning delivery, Shinsegae Mall, department store and marketplace sellers. Each row: regular price, discounted price, unit price, member and card benefit, stock count, sold-out flag, mall and who sells it, the delivering E-mart store, delivery type (쓱배송 / 새벽배송) and promise, rating and review count. Filters: mall, sort (7), price range, delivery type, benefit, sold-out exclusion, category, page. | Pricing teams call search to get keyword search on SSG.COM across E-mart, Traders, early-morning delivery, Shinsegae Mall, dep…. | query, mall, sort, min_price, max_price, ... |
| product | One SSG item by id: its live listing record (regular / discounted / unit price, member and card benefits, stock count, mall, seller kind and vendor id, delivering store, delivery type and promise, early-morning availability and stock) plus its review summary (average rating, total, photo / video counts, attribute percentages, the site's AI summary) and every other mall listing of the same item. | Marketplace operators call product to get one SSG item by id. | item_id, site_no |
| reviews | Buyer reviews of one SSG item, 30 per page: rating, text, date, masked buyer id, option, store, attribute answers (taste, packaging, freshness …), photos; plus the total, average and attribute percentages. | Catalog enrichment teams call reviews to get buyer reviews of one SSG item, 30 per page. | item_id, site_no, sort, filter, page |
| categories | The SSG category tree around one display category: the category, its parent, its sub-categories, its sibling categories, the top-level departments, the category's brands and item count. Use a returned `category_id` as `category_id` in search. | Retail analysts call categories to get the SSG category tree around one display category. | category_id |
Call search from your stack
curl -X POST https://api.reefapi.com/ssg/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"우유"}'import requests
r = requests.post(
"https://api.reefapi.com/ssg/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "우유"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/ssg/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "우유"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.ssg.search with {"query":"우유"}.Who uses this API and why
- Track E-mart grocery prices and unit prices every day for a basket of products.
- Compare SSG.COM prices with Coupang, Kurly and 11st for the same item.
- Watch stock and delivery promise for 쓱배송 and 새벽배송 items.
- Monitor discounts, member benefits and card offers across E-mart, Traders and Shinsegae Mall.
- Collect buyer reviews with taste, packaging and freshness answers for product research.
Questions developers ask before integrating
Do I need an SSG.COM account?
No. Everything is read logged out, and you call reefapi.com from anywhere.
Can I search only E-mart, Traders or early-morning goods?
Yes. mall picks a mall's catalogue (milk: E-mart 79,583, Traders 1,255, Shinsegae Mall 87,506). A mall's catalogue also carries some goods cross-listed from another mall, so each row keeps its own mall. For E-mart store goods only, use delivery=ssg_delivery (218 milk items); for early-morning goods delivery=early_morning (195).
Which filters work?
Mall, seven sorts, price range, delivery type (쓱배송, 새벽배송, Traders delivery, store pickup, today dispatch, department, overseas direct), benefit (free shipping, discounted, N+1, flyer, department sale), sold-out exclusion and category. Each was checked against the unfiltered total of 162,260 for milk: 3,000 to 5,000 won 6,288, free shipping 87,575, 흰우유 category 16,424.
Does the price depend on the E-mart store?
E-mart goods are priced and stocked by the delivering store. SSG uses its default store for a visitor without an address, and every such row says store_defaulted true with the store's name. Choosing another store needs a member address and is not offered.
Do I get reviews?
Yes. reviews returns 30 per page with rating, text, date, masked buyer id, option, store and answers such as taste and freshness, plus the total, average, photo and video counts and SSG's own AI summary. product includes the same summary.
Does product return the full product page?
product returns the item's live listing: prices, unit price, benefits, stock, mall, seller, store, delivery and review summary. The page's description, option list and specification table are not returned.
How deep can I page?
40 rows per page, up to page 100. Pages 1, 2 and 3 of milk shared no item.
What is the SSG.COM (쓱닷컴) API?
SSG.COM (쓱닷컴) API is a ReefAPI endpoint group for e-mart, traders and shinsegae mall on ssg.com: prices, unit prices, stock, delivering store, 쓱배송 and 새벽배송, reviews. It returns live JSON through POST requests under /ssg/v1.
Is the SSG.COM (쓱닷컴) API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. SSG.COM (쓱닷컴) calls use the same shared credit balance as every other ReefAPI engine.
Do I need a SSG.COM (쓱닷컴) login or account?
No login to SSG.COM (쓱닷컴) is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the SSG.COM (쓱닷컴) data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the SSG.COM (쓱닷컴) API use?
SSG.COM (쓱닷컴) actions currently cost 3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call SSG.COM (쓱닷컴) from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call ssg actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the SSG.COM (쓱닷컴) API a SSG.COM (쓱닷컴) scraper?
It is the managed alternative to a DIY SSG.COM (쓱닷컴) scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same e-mart, traders and shinsegae mall on ssg.com: prices, unit prices, stock, delivering store, 쓱배송 and 새벽배송, reviews back as clean JSON.