Bunjang API & Scraper
Bunjang API returns live Bunjang data as clean JSON for bunjang The primary endpoint, search, returns matching records including listing id, title, price, status and status code.
🤖 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.
Developers reach for it when they need to read second-hand listings, asking prices, seller inventory and country-specific listing ids without maintaining one-off scraping code or separate API contracts. If you were about to build or fix a Bunjang scraper, this API is the maintained alternative — it returns the same data as clean JSON, with the proxies, rotation and anti-bot handling already solved. This page covers the live example, request shape, response shape and available actions: search, detail, categories. Every request uses the same ReefAPI envelope, one API key and one shared credit pool, so it fits alongside the rest of your data stack.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/bunjang/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "나이키",
"per_page": 20
}
}{
"ok": true,
"meta": {
"api": "bunjang",
"endpoint": "search",
"mode": "live",
"latency_ms": 1129.3,
"record_count": 20,
"bytes": 43770,
"cache_hit": false,
"upstream_requests": 1,
"charged_credits": 1,
"version": "0.1.0",
"request_id": "6e67c6fa5435497f",
"queue_ms": 1.6,
"fetched_at": "2026-11-03T17:32:01.665Z"
},
"data": {
"results": [
{
"listing_id": "437720376",
"title": "최저가 정품 나이키 프렌치테리 풀집후디",
"url": "https://m.bunjang.co.kr/products/437720376",
"price": 36000,
"currency": "KRW",
"status": "selling",
"status_code": "SELLING",
"is_promoted": true,
"is_bungae_care": false,
"has_video": false,
"favorite_count": 168,
"chat_count": 18,
"updated_at": "2026-10-31T03:00:00Z",
"updated_label": null,
"seller_id": "521765",
"is_official_seller": null,
"image": "https://media.bunjang.co.kr/product/437720376_1_1793593319_w856.jpg",
"images": [
"https://media.bunjang.co.kr/product/437720376_1_1793593319_w856.jpg"
]
},
{
"listing_id": "375680594",
"title": "[6개2만원] 200종아미 HDEX 스투시 스포츠 양말",
"url": "https://m.bunjang.co.kr/products/375680594",
"price": 20000,
"currency": "KRW",
"status": "selling",
"status_code": "SELLING",
"is_promoted": true,
"is_bungae_care": false,
"has_video": false,
"favorite_count": 485,
"chat_count": 181,
"updated_at": "2026-10-27T13:45:45Z",
"updated_label": null,
"seller_id": "85902099",
"is_official_seller": null,
"image": "https://media.bunjang.co.kr/product/375680594_1_1793420092_w856.jpg",
"images": [
"https://media.bunjang.co.kr/product/375680594_1_1793420092_w856.jpg"
]
},
{
"listing_id": "445617282",
"title": "나이키 후드 조끼 핑크/블랙",
"url": "https://m.bunjang.co.kr/products/445617282",
"price": 15000,
"currency": "KRW",
"status": "selling",
"status_code": "SELLING",
"is_promoted": false,
"is_bungae_care": false,
"has_video": false,
"favorite_count": 0,
"chat_count": 0,
"updated_at": "2026-11-03T17:29:30Z",
"updated_label": "2분 전",
"seller_id": "78209835",
"is_official_seller": false,
"image": "https://media.bunjang.co.kr/product/445617282_1_1793726970_w856.jpg",
"images": [
"https://media.bunjang.co.kr/product/445617282_1_1793726970_w856.jpg"
]
}
],
"count": 20,
"total_results": 245898,
"page": 0,
"per_page": 20,
"has_more": true,
"next_page": 1,
"next_cursor": "eyJjIjpudWxsLCJvIjoyMCwiZiI6Ijc5M2MwZjgzODIyNyJ9",
"promoted_count": 4,
"duplicate_listing_ids": 0,
"unparsable_rows_dropped": 0,
"external_ads_excluded": 7,
"source_rows_read": 60,
"no_result": false,
"sort_applied": "best_match",
"filters_applied": {
"query": "나이키",
"sort": "best_match"
},
"filters_acknowledged": [],
"currency": "KRW"
}
}What the Bunjang API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | 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. | Price-intelligence teams call search to search Bunjang listings by keyword and/or category, up to 200 per page. | query, category_id, sort, price_min, price_max, ... |
| detail | 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. | Classifieds aggregators call detail to get one Bunjang listing by id or URL. | listing_id |
| categories | 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. | Resale and arbitrage tools call categories to get bunjang's own category tree. | query, parent_id, max_depth |
Call search from your stack
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}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/bunjang/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "나이키",
"per_page": 20
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/bunjang/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "나이키",
"per_page": 20
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.bunjang.search with {"query":"나이키","per_page":20}.Who uses this API and why
- Price-intelligence teams use Bunjang to search Bunjang listings by keyword and/or category, up to 200 per page.
- Classifieds aggregators use Bunjang to get one Bunjang listing by id or URL.
- Resale and arbitrage tools use Bunjang to get bunjang's own category tree.
Questions developers ask before integrating
What is the Bunjang API?
Bunjang API is a ReefAPI endpoint group for bunjang It returns live JSON through POST requests under /bunjang/v1.
Is the Bunjang API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Bunjang calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Bunjang login or account?
No login to Bunjang 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 Bunjang 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 Bunjang API use?
Bunjang actions currently cost 1 credit per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Bunjang from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call bunjang actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Bunjang API a Bunjang scraper?
It is the managed alternative to a DIY Bunjang 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 bunjang back as clean JSON.
Why does my Bunjang scraper keep getting blocked?
Most Bunjang scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked calls are free.