# 11st API — 11번가 (Korea): search, full product records with option stock and seller rating, reviews and the 베스트 500 ranking

> Keyword search on 11st.co.kr (11번가). Each organic row carries the sell price and the discounted price, discount rate, seller and store, shipping fee, today-dispatch flag and cutoff hour, rating, review count, sales count and the site's badges; sponsored rows are returned apart in `ads`. Filters: sort (7), price range, free shipping, official/department stores, product type (used, overseas direct), top category. Every filter was measured against the unfiltered total; filters the site silently ignores are not offered.
> ReefAPI engine `11st` · 4 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/11st/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free except verified SHEIN NOT_FOUND on product/detail and price (4 credits).
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Send the key as `Authorization: Bearer <key>`, or put it in the URL (`?key=<key>`) when the client has no header field, as ChatGPT does.

## Endpoints

### POST https://api.reefapi.com/11st/v1/search — 3 credits
Keyword search on 11st.co.kr (11번가). Each organic row carries the sell price and the discounted price, discount rate, seller and store, shipping fee, today-dispatch flag and cutoff hour, rating, review count, sales count and the site's badges; sponsored rows are returned apart in `ads`. Filters: sort (7), price range, free shipping, official/department stores, product type (used, overseas direct), top category. Every filter was measured against the unfiltered total; filters the site silently ignores are not offered.

**Parameters:**
- `query` (string, required) — Search keyword, Korean or Latin (e.g. 운동화, nike, 에어팟). Normalised with NFKC before sending.
- `page` (integer, optional, default 1) — Result page, 1-24. The source serves 24 pages of about 84 organic rows; later pages repeat page 24, so they are refused.
- `sort` (enum, optional, default "ranking") — Sort order (the site's own sorts). [one of: ranking, popular, price_asc, price_desc, sales, reviews, newest]
- `min_price` (integer, optional) — Lowest price in KRW (the site's own price range filter; it acts on the site's discount price, so a row may show a final price a little outside the range — measured in BUILD-LOG).
- `max_price` (integer, optional) — Highest price in KRW (see min_price).
- `free_shipping` (boolean, optional) — Only free-shipping products (무료배송).
- `official_store` (boolean, optional) — Only brand-official, certified and department-store sellers (공식·백화점몰).
- `product_type` (enum, optional) — Product type filter (상품 유형). [one of: used, global_direct, exclude_global_direct]
- `category` (enum, optional) — Top-level category (searchCategoryLarge). [one of: 100001316, 100002055, 100005475, 100004750, 100005941, 100005808, 100006456, 100003066, 100002032, 100015973, 100015974]

**Returns:** results[] {product_id, title, url, image, brand, sell_price (판매가), final_price (the discounted price shown), discount_percent, instant_discount, price_from (true = option prices vary), currency, seller_name, seller_id, store_id, store_url, seller_badge, shipping_fee, free_shipping, shipping_text, today_dispatch, dispatch_cutoff_hour, delivery_badge, delivery_types[], rating (0-5), rating_scale, review_count, sales_count, sales_badge, sales_badge_min, point_reward, free_return, labels[], is_11st_lowest_price, is_30day_lowest_price, is_deal, is_official, sold_out, remaining_qty, category_id, adult} + ads[] (sponsored rows, same shape + ad_slot) + total (the source's count) + page + last_page + has_more

**Example request body:**
```json
{
  "query": "운동화"
}
```

### POST https://api.reefapi.com/11st/v1/product — 3 credits
One 11st product in full: title, brand, category path, images; sell price, discounted price, seller / 11st instant discounts, coupon price when a coupon is shown, the maximum-benefit price (할인혜택가) and its breakdown, multi-buy discount; every option with its own stock count, price and sold-out flag; total stock; rating, satisfied %, review / Q&A / like counts; seller (id, store, satisfaction %, response rate, sales level, store likes); delivery (courier, fee, arrival promise, order cutoff, Jeju/island surcharge).

**Parameters:**
- `product_id` (string, required) — 11st product number (digits), exactly as `product_id` in search / ranking rows, or a product URL (www.11st.co.kr/products/<id>).

**Returns:** product {product_id, title, url, images[], brand, brand_id, category_path[], category, catalog_id, market_type, sell_status, sold_out, sell_price, final_price, discount_percent, instant_discount_seller, instant_discount_11st, coupon_price, coupon_discount, market_price, max_benefit_price, max_benefit_discount_percent, price_breakdown[], multi_buy_discount, card_discount_text, lowest_price_label, currency, stock_qty, options[] {level, name, options[] {name, option_id, sell_status, sold_out, stock_qty, add_price, sell_price, final_price, discount_percent, selected, notice}}, rating, satisfied_pct, review_count, qna_count, like_count, category_best, promo_line, max_reward_points, seller {...}, delivery {...}}

**Example request body:**
```json
{
  "product_id": "9165481054"
}
```

### POST https://api.reefapi.com/11st/v1/reviews — 2 credits
Buyer reviews of one 11st product, 10 per page: rating (1-5), text, date, author nickname, chosen option, helpful count, the reviewer's attribute answers, photo / video flags; plus the total and the positive / negative split.

**Parameters:**
- `product_id` (string, required) — 11st product number (digits), exactly as `product_id` in search / ranking rows, or a product URL (www.11st.co.kr/products/<id>).
- `page` (integer, optional, default 1) — Review page (10 per page).
- `sort` (enum, optional, default "recommended") — Review order. [one of: recommended, newest]
- `rating` (enum, optional) — Rating bucket. [one of: positive, negative]
- `media_only` (boolean, optional) — Only photo / video reviews.

**Returns:** results[] {review_id, product_id, rating, text, date, author, option, helpful_count, evaluations[] {name, value}, images[], has_video} + total + positive_count + negative_count + page + has_more

**Example request body:**
```json
{
  "product_id": "9165481054"
}
```

### POST https://api.reefapi.com/11st/v1/ranking — 3 credits
The 11st 베스트 500 sales ranking (top 40 positions per view): overall, by one of 15 category groups, by sub-category, and by shopper gender. Each row: rank, product id, title, struck-through price and price, discount, free-shipping flag, seller, likes.

**Parameters:**
- `group` (enum, optional, default "0") — Category group (cornerNo). [one of: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14]
- `category` (string, optional) — Sub-category id inside the group (dispCtgrNo, digits), e.g. 1001324 스킨케어 in group 8. Needs `group`.
- `gender` (enum, optional, default "all") — Shopper gender view. [one of: all, men, women]

**Returns:** results[] {rank, product_id, title, url, image, strike_price, price, discount_percent, currency, free_shipping, flags[], seller_name, seller_id, seller_url, like_count} + group + group_name + category + category_name + gender + subcategories[] {category, name} (the group's own sub-category ids)

**Example request body:**
```json
{
  "group": "0"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=11st
- Human docs page: https://reefapi.com/docs/11st
- Overview page: https://reefapi.com/11st-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt