# Bunjang API (번개장터) — Korea's largest C2C resale marketplace, strong in sneakers, K-pop goods and collectables: search listings by keyword or category with price, condition and sort filters, read a full listing, and resolve the category tree. Prices in Korean won. No account, no browser.

> Search Bunjang listings by keyword and/or category, up to 200 per page: listing id, title, URL, price in won, whether it is still selling, reserved or sold, whether Bunjang inspected it (번개케어), favourites, chat messages, when it was last updated, the seller's shop id and photos. Filter by price range, condition grade, delivery method, shop type, how recently it was posted, a refining keyword and excluded keywords; sort by relevance, newest or price; include reserved or sold listings on request. Promoted rows are returned in the source's own order and marked `is_promoted` — they are real listings that match the query. The Naver shopping ads Bunjang mixes into its own grid are never returned as listings.
> ReefAPI engine `bunjang` · 3 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/bunjang/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.
- **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). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/bunjang/v1/search — 1 credit
Search Bunjang listings by keyword and/or category, up to 200 per page: listing id, title, URL, price in won, whether it is still selling, reserved or sold, whether Bunjang inspected it (번개케어), favourites, chat messages, when it was last updated, the seller's shop id and photos. Filter by price range, condition grade, delivery method, shop type, how recently it was posted, a refining keyword and excluded keywords; sort by relevance, newest or price; include reserved or sold listings on request. Promoted rows are returned in the source's own order and marked `is_promoted` — they are real listings that match the query. The Naver shopping ads Bunjang mixes into its own grid are never returned as listings.

**Parameters:**
- `query` (string, optional) — Keyword, in Korean or in English. Optional when `category_id` is given.
- `category_id` (string, optional) — Bunjang category id from the `categories` action (e.g. 405100 = 신발 › 스니커즈). A 3-digit id is a top category, 6 digits a sub-category, 9 digits a leaf; any level narrows the search.
- `sort` (enum, optional, default "best_match") — Order of results. Only these four are sent: an unknown order makes Bunjang answer 200 with an undeclared ordering instead of an error, so anything else is rejected here. [one of: best_match, newest, price_asc, price_desc]
- `price_min` (integer, optional) — Lowest price in Korean won (plain won, not 만: 100000 = ₩100,000).
- `price_max` (integer, optional) — Highest price in Korean won (plain won, not 만).
- `condition` (enum, optional) — The seller's own condition grade. Several may be given comma-separated (condition=like_new,lightly_used). `used` is kept as a shorthand for every second-hand grade. The search row itself no longer publishes a grade — `detail` does. [one of: new, like_new, lightly_used, heavily_used, damaged, unstated, used]
- `shipping` (enum, optional) — Delivery method the seller offers. Comma-separated values are allowed. [one of: free, convenience_store, standard]
- `shop_type` (enum, optional) — Seller type. Comma-separated values are allowed. [one of: pro, normal]
- `include_reserved` (boolean, optional, default false) — Include listings the seller marked reserved (예약중). Bunjang leaves them out by default.
- `include_sold` (boolean, optional, default false) — Include sold listings (판매완료). Bunjang leaves them out by default.
- `posted_within` (enum, optional) — Keep only listings created inside this window. An unknown value is silently ignored by Bunjang (it returns the unfiltered count), so anything else is rejected here. [one of: 1d, 3d, 1w, 1m]
- `refine_query` (string, optional) — A second keyword that must also match (Bunjang's 결과내검색). Measured to narrow: with refine_query=128 every returned row carried 128 in its title.
- `exclude_keywords` (string, optional) — Drop listings whose title contains this text (Bunjang's 제외키워드, up to 5 words). Measured to bite: zero returned rows carried the excluded word.
- `page` (integer, optional, default 0) — Zero-based page number. Bunjang itself pages only by cursor, so a page is reached by walking cursors; for a window beyond roughly 600 listings pass `cursor` from the previous response's `next_cursor` instead.
- `per_page` (integer, optional, default 100) — Listings per page, 1-200. Bunjang serves 60 rows per source page, so a larger page is assembled from several of them.
- `cursor` (string, optional) — `next_cursor` from a previous response — the cheapest way to walk deep: one request per page instead of re-walking from the start. It is bound to the query and filters it was produced with and is rejected if they differ. Ignored when `page` is 0 and no cursor is given.

**Returns:** results[]{listing_id, title, url, price (won as the source published it; null when it is not a plain integer), currency (KRW), status (selling|reserved|sold|null), status_code, is_promoted (a paid placement — still a real listing that matches the query), is_bungae_care (inspected by Bunjang), has_video, favorite_count, chat_count (buntalk messages on the listing — NOT the comment count), updated_at, updated_label (the source's own relative label), seller_id, is_official_seller, image, images[]}, count, total_results (Bunjang's own count for the ordering asked for), page, per_page, has_more, next_page, next_cursor (pass it back as `cursor` to continue), promoted_count, duplicate_listing_ids (the same listing can appear twice in one page, once promoted), unparsable_rows_dropped, external_ads_excluded (Naver shopping ads the grid mixes in — never returned as listings), source_rows_read, no_result, sort_applied, filters_applied (what was sent), filters_acknowledged (what Bunjang itself says it applied), currency. The row no longer carries condition, free_shipping, location, category_id, tags, comment_count, is_pro_shop, is_business_seller, inspection_status, badge, neighborhood_only or is_adult: Bunjang stopped publishing them on a search row in 2026-10. `detail` still publishes every one of them, and condition / shipping / shop_type are still filterable here.

**Example request body:**
```json
{
  "query": "나이키",
  "per_page": 20
}
```

### POST https://api.reefapi.com/bunjang/v1/detail — 1 credit
One Bunjang listing by id or URL: full description, price in won and the seller's original price, quantity, the seller's own condition grade (new, like_new, lightly_used, heavily_used…), sale status (selling, reserved, sold), category path, brand, hashtags, size and variant options, shipping (free or the fee in won, and whether meeting in person is offered), 번개페이 safe-payment availability, favourites / views / comments / chats, posting and update times, every photo, and the public shop: name, rating, review and sales counts, followers, join date.

**Parameters:**
- `listing_id` (string, required) — Listing id — the number in a Bunjang product URL (m.bunjang.co.kr/products/423853877) — or the full URL.

**Returns:** listing{listing_id, title, url, description, price, original_price, currency, quantity, condition (the seller's own grade, null when the source publishes none), status (selling|reserved|sold|null), status_code, is_promoted, is_hidden, inspection_status, category{id, name}, category_path[]{id, name}, brand{id, name}, keywords[], options[]{group, value}, shipping{free_shipping, fee, in_person}, safe_payment{enabled, shipping, in_person, seller_prefers}, favorite_count, view_count, comment_count, chat_count, created_at, updated_at, updated_label, image, images[], image_count, seller{id, name, url, image, rating, review_count, sales_count, follower_count, is_pro_shop, joined_at}, seller_listing_count, report_url}

**Example request body:**
```json
{
  "listing_id": "423853877"
}
```

### POST https://api.reefapi.com/bunjang/v1/categories — 1 credit
Bunjang's own category tree — every id that `search`'s `category_id` accepts, with the full name path and the number of listings the site currently counts in each. Narrow it with a name search, a parent id or a depth limit.

**Parameters:**
- `query` (string, optional) — Keep only categories whose name contains this text (case-insensitive).
- `parent_id` (string, optional) — Keep only this category and the tree beneath it.
- `max_depth` (integer, optional, default 3) — How deep to walk the tree: 1 top categories, 2 sub-categories, 3 leaves.

**Returns:** categories[]{category_id, name, depth, parent_id, path[], path_ids[], listing_count}, count, max_depth, query, parent_id

**Example request body:**
```json
{
  "max_depth": 1
}
```

## 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=bunjang
- Human docs page: https://reefapi.com/docs/bunjang
- Overview page: https://reefapi.com/bunjang-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
