# 북오프 BookOff 일본 중고책·만화·CD·게임 시세 — 중고가·재고 (`jpmarketdata/bookoff-market-kr`) Actor

키워드를 입력하면 일본 북오프(BookOff) 공식 온라인 스토어에서 중고책·만화·CD·DVD·게임이 얼마인지 알려줍니다. 중고 대표가와 범위는 검색 결과 전체 기준, 판매중/품절 건수와 정가 대비 할인율은 120건 표본 기준입니다. 키워드당 $0.02, 결과 없으면 과금 없음. BookOff Japan used prices per keyword. Unofficial.

- **URL**: https://apify.com/jpmarketdata/bookoff-market-kr.md
- **Developed by:** [h ichi](https://apify.com/jpmarketdata) (community)
- **Categories:** E-commerce, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $20.00 / 1,000 keyword market analyzeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## 북오프 BookOff 일본 중고책·만화·CD·게임 시세 — 중고가·재고

**하는 일:** 키워드를 입력하면 일본 북오프(BookOff) 공식 온라인 스토어에서 중고책·만화·CD·DVD·게임이 얼마인지 알려줍니다.

**입력:** 일본어 키워드 1개 이상, 예: `ガンダム`; 선택으로 장르(도서 / 만화 / 잡지 / CD / DVD / 게임).

**결과:** 중고 대표가와 범위(최저–최고, 중간 50%)는 보통 검색 결과 전체 기준; 120건 표본(기본값은 가장 싼 120건) 기준으로 판매중/품절 건수, 정가 대비 할인율, 새 상품 가격, 주요 장르. 선택: 상품 1건당 1행.

**가격:** 키워드당 $0.02(입력한 키워드마다 과금), 목록까지 원하면 상품당 +$0.002(기본값 꺼짐). 결과 없음 = 과금 없음.

**예시:** `ガンダム` 입력 → 4,893건 · 중고 대표가 ¥550(범위 ¥99–77,000) · 표본 120건의 82%가 품절 · 중고가는 정가보다 약 78% 낮음.

**In English:** Type a keyword and get what used books, manga, CDs, DVDs and games cost on BookOff's official online store in Japan. You get typical used price and range usually read across all matching listings, plus in-stock vs sold-out counts, discount vs list price and new-copy price from a 120-listing sample.

> 비공식 도구 / Unofficial — BOOKOFF와 무관하며 공개 페이지만 읽습니다. Not affiliated with BOOKOFF; reads public pages only.

### 한국어

#### 누구를 위한 Actor 인가 (Who this is for)

**일본 중고책·일본 만화 소싱은 한국에서 이미 자리 잡은 사업입니다.** 헌책 도매, 만화 전권 세트 구매대행, CD·DVD·게임 셀렉션, 애니메이션 굿즈 리셀 — 모두 같은 질문에서 출발합니다. "이 물건, 일본 중고가가 대체 얼마인가." 그리고 그 기준점이 바로 **북오프(BookOff / ブックオフ)** 입니다. 일본 최대 중고 체인으로, 800개가 넘는 오프라인 매장이 하나의 공식 온라인 스토어 카탈로그를 공유하며 서적·만화·잡지·CD·DVD·게임을 다룹니다. 한국 구매자는 **구매대행**으로 사들여 국내에서 되파는 흐름이 일반적이고, 이는 중국어권 구매자와는 **별개의 구매층**입니다.

이 Actor 는 원본 상품 목록이 아니라 **집계된 숫자 자체**를 돌려줍니다. 키워드 단위 과금, 약 8초 — 게다가 중고가의 범위는 보통 첫 페이지 표본이 아니라 **검색 결과 전체**에서 읽습니다.

- **`usedPriceJpy` — 최저가, 중간 50% 구간, 중앙값, 최고가.** 4,893건이 잡히는 키워드라면 그 4,893건 전체에서 읽은 진짜 값이고, 요청은 5번뿐입니다. 120건 표본에서 추정한 값이 아닙니다.
- **`outOfStockRatioSampled`** — 북오프는 품절 상품을 **마지막 가격을 붙인 채** 계속 노출합니다. 그래서 품절 비율은 회전율 신호이고, 품절 가격은 일본 중고 미디어에서 공개적으로 얻을 수 있는 가장 *실거래가에 가까운 값*입니다.
- **`stockBreakdown`** — 재고 있음 / 재고 부족 / 마지막 1점 / 품절.
- **`discountVsListPricePct`** — 중고가가 일본 정가(定価)보다 얼마나 싼가.
- **`newPriceJpy`**, **`genreTop`**, 그리고 현재 환율 기준 달러 환산.
- 선택: 표본으로 잡은 상품 개별 명세(제목, 가격, 상태, 재고, 정가, 할인율, 발매일, 매장 수령 가능 여부, URL).

로그인 불필요, API 키 불필요, 실행 사이에 아무것도 저장하지 않습니다.

이 Actor 는 영어판 [BookOff Japan Used Media](https://apify.com/jpmarketdata/bookoff-market-checker) 의 **한국어 언어 패키지**입니다. 수집 로직과 통계 기준은 완전히 동일하고, 제목·스토어 설명·문서·입력 항목 라벨만 한국어로 다시 썼습니다.

#### 개요 Overview

키워드마다 `market_summary` 요약 레코드 1건을 반환합니다. 핵심은 **기준이 표시된 중고가**이고(검색 결과 전체 기준인지 120건 표본 기준인지 — 아래 절 참조), 여기에 재고 구성, 품절 비율, 할인율, 신품 가격, 장르 구성이 함께 붙습니다.

#### 입력 Input

| 필드 | 예시 | 설명 |
|---|---|---|
| `keywords` | `["ガンダム"]` | 일본어 적중률이 가장 높습니다 — 카탈로그가 일본어라, 영어 키워드는 로마자로 인쇄된 제목에만 적중합니다(실측 2026-08-18: `Gundam` 498건 / `ガンダム` 4,893건). 키워드 1개당 $0.02 |
| `genreCode` | `"11"` | 선택: `12` 서적 / `11` 만화 / `13` 잡지 / `31` CD / `71` DVD·블루레이 / `51` 게임. 비우면 = 전체 장르 |
| `maxItemsPerKeyword` | `120` | 재고·할인·장르 구성을 계산하려고 읽는 건수(30–360, 페이지당 120). **중고가 숫자에는 영향이 없습니다.** 120 미만이면 반환되는 개별 상품 건수만 제한합니다 |
| `includeIndividualItems` | `false` | 켜면 표본으로 잡은 상품마다 레코드를 1건씩 추가 출력(건당 +$0.002) |
| `convertToUsd` | `true` | 현재 환율로 달러 통계를 함께 표시 |

```json
{
    "keywords": ["ガンダム", "ワンピース"],
    "genreCode": null,
    "maxItemsPerKeyword": 120,
    "includeIndividualItems": false,
    "convertToUsd": true
}
```

자주 쓰는 일본어 키워드 대조: 건담 = `ガンダム` / 원피스 = `ワンピース` / 귀멸의 칼날 = `鬼滅の刃` / 드래곤 퀘스트 = `ドラゴンクエスト` / 요네즈 켄시 = `米津玄師` / 화집 = `画集`.

#### 출력 Output

필드명은 영어를 유지합니다. API 인터페이스이기 때문입니다.

*2026-07-25 실측 (BookOff 실제 페이지, 키워드 ガンダム); 2026-08-18 재측정에서도 적중 건수는 4,893건*

```json
{
  "type": "market_summary",
  "keyword": "ガンダム",
  "genre": null,
  "genreName": null,
  "totalListingsFound": 4893,
  "sampledListings": 120,
  "keywordStatus": "ok",
  "hint": null,
  "usedPriceJpy": {"min": 99, "q1": 330, "median": 550, "q3": 1375, "max": 77000, "count": 4893},
  "usedPriceJpyBasis": "population_quantiles",
  "newPriceJpy": {"min": 528, "q1": 660, "median": 990, "q3": 1650, "max": 6600, "count": 14},
  "stockBreakdown": {"inStock": 12, "lowStock": 6, "lastOne": 4, "outOfStock": 98},
  "outOfStockRatioSampled": 0.8167,
  "discountVsListPricePct": {"median": 78},
  "genreTop": [["コミック", 61], ["書籍", 34], ["DVD・ブルーレイ", 12]],
  "usedPriceUsd": {"min": 0.63, "q1": 2.11, "median": 3.52, "q3": 8.8, "max": 492.8},
  "exchangeRateJpyUsd": 0.0064,
  "checkedAt": "2026-07-25T09:00:00+00:00",
  "sourceUrl": "https://shopping.bookoff.co.jp/search/keyword/%E3%82%AC%E3%83%B3%E3%83%80%E3%83%A0?per-page=120&sort=50&p=1"
}
```

`q1` 과 `q3` 은 중간 50% 구간의 양 끝입니다. 즉 ガンダム 상품의 절반이 ¥330–¥1,375 사이에 있습니다.

`includeIndividualItems: true` 로 켜면 상품마다 레코드가 1건씩 더 나옵니다(2026-08-18 실측, 키워드 `ONE PIECE 105`):

```json
{
  "type": "item",
  "keyword": "ガンダム",
  "id": "0019946797",
  "title": "ONE PIECE(巻百五) ジャンプC",
  "priceJpy": 220,
  "condition": "used",
  "stockStatus": "in_stock",
  "listPriceJpy": 528,
  "discountPct": 58,
  "releaseDate": "2023/03/03",
  "storePickup": true,
  "url": "https://shopping.bookoff.co.jp/used/0019946797"
}
```

#### 검색 결과 전체 기준인가, 120건 표본 기준인가 — 모든 숫자에 표시합니다

모든 레코드에는 **`usedPriceJpyBasis`** 가 붙습니다. 이 숫자가 어떻게 만들어졌는지 추측할 필요가 없습니다:

| `usedPriceJpyBasis` | 의미 | 어떻게 얻는가 | 언제 나오는가 |
|---|---|---|---|
| **`exact`** | **적중한 모든 상품**에 대한 진짜 전수 통계 | 결과 집합이 한 페이지에 다 들어감(120건 이하). 전부 읽습니다 — 요청 1회 | 좁은 키워드 |
| **`population_quantiles`** | 최저가·중간 50% 구간·중앙값·최고가를 **표본이 아니라 적중한 모든 상품**에서 읽음, `count` = 전체 적중 건수 | 중고 가격 낮은 순으로 정렬한 뒤 그 순위가 실린 페이지로 곧장 점프합니다(예: 4,893건 중 1,224 / 2,447 / 3,670번째 = 11 / 21 / 31페이지). 여기에 최고가용 높은 순 1페이지를 더해 총 5회 요청 | 대부분의 키워드 |
| **`null`** | 아무것도 찾지 못해 설명할 가격이 없음(`keywordStatus: "not_found"`, 과금 없음) | — | 0건 키워드 |
| **`sample`** | 읽은 상품들만으로 낸 일반적인 통계, `count` = 읽은 건수 | 폴백. 페이지가 넘어가도 가격이 **꾸준히 올라가지 않을** 때, 또는 다중 키워드 실행이 시간 예산에 걸렸을 때 사용됩니다(이때는 `truncatedForTimeLimit: true` 도 함께 설정됩니다) | 드묾 |

폴백이야말로 핵심입니다. 스토어가 나중에 정렬 방식을 바꾸면 이 Actor 는 조용히 틀린 숫자를 돌려주는 대신 **전체 기준이라고 말하기를 멈추고** 그 행을 `sample` 로 표시합니다.

**0건 키워드도 한 행을 돌려줍니다**: 모든 가격 필드는 null, `keywordStatus: "not_found"`, `usedPriceJpyBasis: null`(측정한 것이 없으니 기준을 주장하지 않습니다), 그리고 다음에 무엇을 시도하면 되는지 알려주는 `hint` 한 줄이 붙습니다 — 과금은 없습니다. 적중한 키워드는 `keywordStatus: "ok"`, `hint: null` 입니다.

`newPriceJpy`, `stockBreakdown`, `outOfStockRatioSampled`, `discountVsListPricePct`, `genreTop` 은 **항상 표본 기준**입니다(표본 크기는 `sampledListings`). 기본값 `maxItemsPerKeyword: 120` 에서 표본은 가장 싼 120건이므로, 재고 구성은 "이 시장의 저가 구간"으로 읽어야 합니다. 240/360 으로 올리면 어차피 읽는 페이지를 활용해 표본이 가격대 전체로 자동으로 퍼집니다 — **추가 요청도, 추가 시간도 없습니다.**

#### 이 Actor 가 하지 않는 것

- **트레이딩 카드·피규어·하비 상품은 다루지 않습니다.** 북오프 공식 온라인 스토어에는 TCG / 하비 장르 자체가 없습니다 — 서적·만화·잡지·CD·DVD·블루레이·게임뿐입니다. 카드와 피규어는 만다라케(Mandarake) 같은 소스를 이용하세요.
- **시계열을 만들지 않습니다.** 북오프는 정가 판매 중고 소매점이라 가격은 「호가」입니다. 품절 상품의 가격은 「마지막으로 내걸렸던 가격」으로, 실제로 팔린 가격에 가깝긴 하지만 상품 마스터의 가격일 뿐 개별 거래 기록이 아니며 판매 일시도 붙지 않습니다.
- **영어를 일본어로 번역하지 않습니다.** 카탈로그가 일본어라 영어 키워드는 로마자로 인쇄된 제목에만 적중하며, 시장의 일부만 보입니다 — 실측 2026-08-18: `One Piece` 1,731건 / `ワンピース` 2,174건(80%), `camera` 1,795건 / `カメラ` 9,842건(18%), `Gundam` 498건 / `ガンダム` 4,893건(10%), `manga` 689건 / `漫画` 38,239건(2%). 전체를 보려면 일본어(ガンダム, 鬼滅の刃, 米津玄師)를 쓰세요.
- **서버 측 「재고 있는 것만」 필터를 쓰지 않습니다.** 사이트 UI 에는 이런 필터가 있지만 쿼리 파라미터가 공개적으로 안정적이지 않아, v1 은 서버 측에서 걸러내는 대신 표본으로 재고 구성을 보고합니다.
- **개인정보를 다루지 않습니다.** 북오프는 퍼스트파티 소매점이라 판매자가 존재하지 않습니다.

#### 가격 Pricing — 키워드당 $0.02

| 과금 이벤트 | 가격 | 언제 발생하는가 |
|---|---|---|
| 키워드 요약 | **$0.02** | 키워드 1건마다. 입력한 키워드는 모두 과금됩니다 |
| 개별 상품 레코드 | **$0.002** | 「개별 상품 출력」을 켰을 때만(기본값 꺼짐) |

기본 실행(키워드 1개, 요약만)은 **$0.02**, 약 8초가 걸립니다. 쓴 만큼만 내는 종량 과금이며 월 정액은 없습니다. **결과가 0건인 키워드는 과금되지 않습니다.**

#### 주의사항 Notes & limits

- `totalListingsFound` 는 재고 유무와 상관없이 적중한 모든 상품을 셉니다.
- 스토어 기본 정렬은 「人気順」(인기순, 베스트셀러·광고 가중)이라, 이 Actor 는 통계가 왜곡되지 않도록 **항상 정렬을 명시해서** 요청합니다.
- 읽기 전용이며 속도 제한이 걸려 있습니다(1요청 / 1.5초). 키워드당 5회 요청. 다중 키워드 실행에는 95초 소프트 예산이 있습니다. 예산을 넘긴 키워드도 요약은 반환하지만 `truncatedForTimeLimit` 이 표시되고 `usedPriceJpyBasis: "sample"` 이 됩니다.
- ブックオフコーポレーション株式会社(북오프 코퍼레이션)와는 아무런 관계가 없습니다. 데이터는 시장 조사용이며, 금액이 큰 거래 전에는 직접 확인하세요.

#### 활용 사례 Use cases

- **수입·리셀 소싱** — 구매대행으로 주문하기 전에 일본 중고 가격대를 확인하고, eBay / 메루카리의 실거래가와 비교합니다.
- **내 재고 가격 책정** — **검색 결과 전체**에서 읽은 중앙값과 중간 50% 구간의 위쪽 끝이 일본 시장이 실제로 받는 가격이지, 가장 목소리 큰 매물의 호가가 아닙니다.
- **회전율 스크리닝** — 품절 비율이 높고 재고 건수가 얇으면 그 타이틀은 팔리는 물건이고, 반대면 창고에 쌓입니다.
- **카탈로그 / 판권 조사** — 어떤 시리즈, 어떤 레이블, 어떤 아티스트의 중고 공급이 얼마나 두꺼운지, 정가 대비 몇 퍼센트에 나오는지.
- **리프라이싱 및 모니터링** — 스케줄 실행으로 키워드별 중앙값의 시간 변화를 추적합니다.

***

### English

#### Overview

Used-price figures for any keyword on BookOff's official Japanese online store, one row per keyword: the cheapest price, the middle 50% range, the median and the dearest, usually read across **every matching listing** — not a first-page sample — plus the stock split, the sold-out share and the discount against list price.

This listing is the **Korean-language package** of our English Actor [BookOff Japan Used Media](https://apify.com/jpmarketdata/bookoff-market-checker). It reads the same pages and works out the same numbers; only the documentation, store copy and input labels are written for Korean-speaking buyers (일본 중고책 / 일본 만화) who source Japanese used books, manga, CDs, DVDs and games through proxy-buying services and resell them domestically.

#### Input

| Field | Example | Notes |
|---|---|---|
| `keywords` | `["ガンダム"]` | Japanese works best — an English keyword only matches titles printed in Latin letters (`Gundam` 498 vs `ガンダム` 4,893). $0.02 per keyword |
| `genreCode` | `"11"` | Optional: `12` Books / `11` Comics / `13` Magazines / `31` CD / `71` DVD & Blu-ray / `51` Games |
| `maxItemsPerKeyword` | `120` | Listings read for the stock / discount / genre mix (30–360). Does **not** change the used-price figures |
| `includeIndividualItems` | `false` | Turn on to also get each read listing as its own row (+$0.002 each) |
| `convertToUsd` | `true` | Adds USD figures at the current exchange rate |

#### Output

One `type: "market_summary"` row per keyword — `usedPriceJpy` with **`usedPriceJpyBasis`** (`exact` = every matching listing read / `population_quantiles` = read across every matching listing / `sample` = only the listings that were read), `newPriceJpy`, `stockBreakdown`, `outOfStockRatioSampled`, `discountVsListPricePct`, `genreTop`, USD conversion — see the JSON example in the Korean section — plus optionally one `item` row per read listing.

#### Pricing

| Event | Price |
|---|---|
| Keyword summary | **$0.02** |
| Individual listing row | **$0.002** each |

Individual listings are OFF by default, so a default run is a flat **$0.02** per keyword and takes about 8 seconds. You pay per keyword; there is no monthly fee. A keyword that returns zero listings is never charged.

#### Notes & limits

- **Trading cards, figures and hobby goods are out of scope** — BookOff's official online store has no TCG / hobby genre. Use a Mandarake source for those.
- BookOff is a fixed-price retailer: prices are **asking prices**, and a sold-out product's price is the last price it was offered at — a good stand-in for what it sold for, but a product-master price with no sale date, so no history over time.
- The store's default order is 人気順 (popularity, ad/best-seller weighted); this Actor always sends an explicit order.
- `newPriceJpy`, `stockBreakdown`, `outOfStockRatioSampled`, `discountVsListPricePct` and `genreTop` always come from the sample only (`sampledListings` gives its size).
- Read-only and throttled (1 request / 1.5 s), 5 requests per keyword, 95-second soft budget. No personal data — BookOff is a first-party retailer, there are no sellers.

***

### 日本語

#### 概要 Overview

ブックオフ公式オンラインストアの中古相場を、キーワード1件につき1レコードで返します。特徴は先頭ページのサンプル統計ではなく**検索結果の全件から読み取った中古価格**（安い順に並べ替え、その順位が載っているページへ直接ジャンプ）。あわせて在庫内訳、在庫なし比率、定価に対する割引率、新品価格、ジャンル内訳、USD換算。韓国語圏の利用者（일본 중고책 / 일본 만화 — 購入代行で仕入れて国内で転売する層。中国語圏とは別の買い手プールです）向けに韓国語で書き直したパッケージで、英語版は [BookOff Japan Used Media](https://apify.com/jpmarketdata/bookoff-market-checker)（取得・統計処理は同一）。

#### 入力 Input

`keywords`（**日本語**推奨、カタログが日本語のため）／`genreCode`（12=書籍 / 11=コミック / 13=雑誌 / 31=CD / 71=DVD・ブルーレイ / 51=ゲーム）／`maxItemsPerKeyword`（既定 120、30〜360）／`includeIndividualItems`（既定 OFF）／`convertToUsd`（既定 ON）。

#### 出力 Output

キーワードごとに `market_summary` を1件。**数値の根拠は必ず明示**します：`usedPriceJpyBasis` が `exact`（全件が1ページに収まり全数集計）/ `population_quantiles`（検索結果の全件から読み取り）/ `sample`（読み取った件数だけの統計）のどれかを示し、ページ間で価格の並びが単調に上がらない場合や時間予算（95秒）を超えた場合は**全件基準を名乗らず** `sample` に落ちます。在庫内訳・割引率・ジャンル内訳・新品価格は常にサンプル基準です。

#### 料金 Pricing

キーワードサマリー（`keyword-analyzed`）**$0.02**／個別商品レコード（`item-scraped`）**$0.002 / 件**。個別明細は**既定 OFF** なので既定実行は $0.02 固定です。**0件のキーワードには課金されません。** 使った分だけの従量課金です。

#### 注意 Notes

**トレカ・ホビー・フィギュア系のジャンルは公式オンラインストアに存在しないため対象外**です（書籍・コミック・雑誌・CD・DVD・ゲームのみ）。ブックオフは定価販売の中古小売であり、価格は「出品価格」、売り切れ商品の価格は「最後に提示されていた価格」で販売日時は取得できません（時系列分析は不可）。既定の並び順（人気順）は広告・売れ筋バイアスがあるため常にソートを明示します。リクエストは1.5秒間隔・キーワードあたり5リクエスト。ブックオフコーポレーション株式会社とは無関係です。

### 문제가 생기면

- **숫자가 이상하거나 실행이 실패했나요?** **Issues** 탭에 남겨 주세요. 모두 읽고 2 영업일 안에 답합니다(일본 시간).
- **가짜 「빈 결과」는 돌려주지 않습니다.** 사이트를 읽을 수 없으면 실행이 실패하고 그렇게 알려줍니다.
- **결과가 없으면 요금이 없습니다.** 실제로 받은 결과에만 요금이 붙습니다.
- **매주 점검합니다.** 자동 테스트가 매주 돌아가고, 사이트가 바뀌면 고칩니다.
- **공개 페이지만 봅니다.** 로그인하지 않고 개인정보도 다루지 않으며, 사이트에 부담을 주지 않습니다.

### 같은 제작자의 다른 도구

- [일본 화장품 랭킹 앳코스메 @cosme Top 50 평점·가격](https://apify.com/jpmarketdata/cosme-beauty-market-kr)
- [만다라케 Mandarake 일본 중고 피규어·만화 시세 — 판매가·품절가](https://apify.com/jpmarketdata/mandarake-market-kr)
- [유유테이 Yuyu-tei 일본 카드 싱글 시세 — 판매가·매입가](https://apify.com/jpmarketdata/yuyutei-tcg-price-kr)
- [@cosme Japan Beauty Ranking — Top 50 Ratings & Prices](https://apify.com/jpmarketdata/cosme-beauty-market-checker)
- [Digimart Japan Used Guitar & Instrument Prices](https://apify.com/jpmarketdata/digimart-instrument-market-checker)
- [Fujiya Camera Japan Used Camera Prices by Condition](https://apify.com/jpmarketdata/fujiya-camera-market-checker)
- [HobbyLink Japan Gunpla & Figure Prices + Stock Status](https://apify.com/jpmarketdata/hlj-hobby-market-checker)
- [Iosys Japan Used iPhone & Phone Prices by Condition](https://apify.com/jpmarketdata/iosys-phone-market-checker)

이 도구의 다른 언어판: [English](https://apify.com/jpmarketdata/bookoff-market-checker) · [中文](https://apify.com/jpmarketdata/bookoff-market-cn)

모든 도구(일본 마켓플레이스, 부동산, 채용, 경정·경륜·경마, 예측시장): <https://apify.com/jpmarketdata>

### 면책 조항

비공식 독립 도구입니다 — **BOOKOFF와 제휴·보증·후원 관계가 없습니다**. 상품명과 로고는 각 소유자의 것이며 여기서는 데이터 출처를 나타낼 뿐입니다. 공개 페이지에서 읽은 데이터이며 시장 조사용입니다. 행동하기 전에 직접 확인하세요.

# Actor input Schema

## `keywords` (type: `array`):

하나 이상의 검색 키워드. 일본어가 가장 잘 맞습니다(ガンダム, ワンピース, ドラゴンクエスト, 米津玄師). 카탈로그가 일본어라 영어 키워드는 로마자로 인쇄된 제목에만 적중합니다 — 실측 2026-08-18: 'Gundam' 498건 vs 'ガンダム' 4,893건, 'One Piece' 1,731건 vs 'ワンピース' 2,174건. 0건 키워드는 keywordStatus 'not\_found' 로 돌아오며 과금되지 않습니다. 키워드 1개당 $0.02.

## `genreCode` (type: `string`):

검색을 북오프의 한 장르로 한정합니다: 12=서적(書籍), 11=만화(コミック), 13=잡지(雑誌), 31=CD, 71=DVD·블루레이, 51=게임(ゲーム). 비워 두면 전체 장르를 검색합니다. 참고: 트레이딩 카드와 하비/피규어 장르는 공식 온라인 스토어에 존재하지 않습니다.

## `maxItemsPerKeyword` (type: `integer`):

재고 구성·할인율·장르 구성을 계산하려고 키워드마다 몇 건을 살펴볼지 정합니다. 중고 가격 사분위수는 결과 전체 모집단에서 읽으므로 이 값의 영향을 받지 않습니다. 결과는 한 페이지에 120건이라 120을 넘는 값은 어차피 가져오는 분위수 페이지를 표본에 더할 뿐이고(추가 요청도 추가 시간도 없이 표본이 가격대 전체로 퍼집니다), 120 미만의 값은 '개별 상품 출력'이 켜져 있을 때 반환·과금되는 건수만 제한합니다(+$0.002/건).

## `includeIndividualItems` (type: `boolean`):

기본값 꺼짐: 실행 1회당 키워드 요약이 $0.02 정액입니다. 켜면 표본으로 잡은 상품마다(제목, 가격, 상태, 재고 상태, 정가, 할인율, 발매일, 매장 수령, URL) 레코드를 추가로 출력하며 건당 +$0.002가 부과됩니다.

## `convertToUsd` (type: `boolean`):

현재 환율(open.er-api.com)로 엔화 통계 옆에 달러 통계를 함께 표시합니다.

## Actor input object example

```json
{
  "keywords": [
    "ガンダム"
  ],
  "maxItemsPerKeyword": 120,
  "includeIndividualItems": false,
  "convertToUsd": true
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "keywords": [
        "ガンダム"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("jpmarketdata/bookoff-market-kr").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "keywords": ["ガンダム"] }

# Run the Actor and wait for it to finish
run = client.actor("jpmarketdata/bookoff-market-kr").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "keywords": [
    "ガンダム"
  ]
}' |
apify call jpmarketdata/bookoff-market-kr --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,jpmarketdata/bookoff-market-kr"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/VrJm5DATECzmuynQl/builds/8Qt0giC7KjKgOSvXm/openapi.json