Bunjang
Bunjang
/bunjang/v1/search1 creditSearch Bunjang listings by keyword and/or category, up to 200 per page: listing id, title, URL, price in won, whether the seller marked it new or used, whether it is still selling, reserved or sold, free shipping, the public neighbourhood label, the seller's shop id and pro-shop status, favourites, comments, hashtags and photos. Filter by price range, condition and category; sort by relevance, newest or price. Promoted rows are returned in the source's own order and marked `is_promoted` — they are real listings that match the query.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | optional | — | Keyword, in Korean or in English. Optional when `category_id` is given. |
| category_id | 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 = best_match | optional | best_match · newest · price_asc · price_desc | Order of results. Only these four are sent: Bunjang answers 200 to an unknown order and silently serves the newest-first list instead. |
| price_min | optional | 0– | Lowest price in Korean won (plain won, not 만: 100000 = ₩100,000). |
| price_max | optional | 0– | Highest price in Korean won (plain won, not 만). |
| condition | optional | new · used | Bunjang's search filter only knows these two steps. The finer grade the seller chose (like_new, lightly_used, heavily_used…) is published by the `detail` action. |
| page = 0 | optional | 0– | Zero-based page number. |
| per_page = 100 | optional | 1–200 | Rows per page, 1-200. Bunjang serves nothing above 200. |
/bunjang/v1/detail1 creditOne 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.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| listing_id | required | — | Listing id — the number in a Bunjang product URL (m.bunjang.co.kr/products/423853877) — or the full URL. |
/bunjang/v1/categories1 creditBunjang'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.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | optional | — | Keep only categories whose name contains this text (case-insensitive). |
| parent_id | optional | — | Keep only this category and the tree beneath it. |
| max_depth = 3 | optional | 1–3 | How deep to walk the tree: 1 top categories, 2 sub-categories, 3 leaves. |
curl -X POST https://api.reefapi.com/bunjang/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"나이키","per_page":20}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.
Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.
Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.
No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.
Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.