# Yahoo! Auctions 야후 옥션 Japan Sold Comps — Cross-Border (`jpmarketdata/yahoo-auction-comps-kr`) Actor

일본 직구·구매대행·리셀러 필수: 일본어 키워드 하나로 야후 옥션(야후재팬 경매 / Yahoo! Auctions Japan)에서 종료된 경매의 실제 낙찰가 시세를 받습니다 — 중앙값, 평균, 사분위 가격대, 입찰 경쟁도, 달러 환산 포함. 일본 구매대행 견적과 리셀 가격 책정에 그대로 씁니다. Sold-price stats from closed Japanese auctions, from $0.02 per keyword, no subscription.

- **URL**: https://apify.com/jpmarketdata/yahoo-auction-comps-kr.md
- **Developed by:** [h ichi](https://apify.com/jpmarketdata) (community)
- **Categories:** E-commerce
- **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 sold-price analyses

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/platform/actors/running/actors-in-store#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

## Japan Auction Sold Comps for Korean Cross-Border Buyers

**한국어 · English · 日本語** — 야후 옥션(야후재팬 경매 / Yahoo! Auctions Japan)에서 종료된 경매의 실제 낙찰가 시세를, 한 번의 호출로 결론 한 줄까지.

***

### 한국어 안내

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

**일본 직구·구매대행·리셀러**를 위한 Actor입니다. 야후 옥션이나 메르카리에서 물건을 잡아 국내 중고나라·번개장터·당근·쿠팡이나 eBay로 넘기는 분들이 대상입니다. 가격의 근거는 일본 사이트에 **붙어 있는 호가**가 아니라 **일본 사람이 실제로 얼마에 낙찰받았는가**, 즉 낙찰가 시세입니다. 이 Actor는 야후 옥션의 「종료된 경매」 낙찰가를 곧바로 견적에 쓸 수 있는 통계 한 줄로 바꿔 줍니다. 중앙값, 평균, 사분위 가격대, 그리고 입찰 경쟁도(몇 명이 붙었는가)까지. 일본어 페이지를 열 장씩 넘길 필요도, 직접 엑셀을 만들 필요도 없습니다.

한 줄로: **매입 전에 시세부터 확인하고, 견적에 근거를 얹고, 리셀에서 밑지지 않기.**

#### 개요 Overview

- 일본어 키워드를 넣으면 야후 옥션의 공개 「종료 경매」 검색 페이지(closedsearch)를 표본 추출해 다음을 출력합니다.
  - 키워드마다 **낙찰가 시세 요약**(`price_summary`) 한 건: 최저가, p25, **중앙값**, p75, 최고가, 평균
  - **입찰 수 통계**(`bidCountStats`): 이 물건이 얼마나 경쟁이 붙는지 판단하는 지표
  - 선택 사항인 **개별 경매 명세**: 표본 경매마다 제목, 낙찰가, 입찰 수, 상태, 종료 시각, 사진, 직링크
- 통계는 **실제로 낙찰된 경매(입찰 1회 이상)만으로** 계산합니다. 유찰은 제외됩니다.
- **달러 환산**(실시간 환율)을 지원하므로 eBay·국내 시세와 바로 비교할 수 있습니다.
- 공개 페이지만 읽고, 로그인하지 않으며, 판매자 개인정보는 다루지 않습니다. 요청은 스로틀링되어 있습니다.

#### 입력 Input

| 필드 | 예시 | 설명 |
|---|---|---|
| `keywords` | `["ポケモンカード リザードン psa10", "ロレックス デイトナ"]` | **키워드는 일본어로**: 야후 옥션은 일본 사이트라 일본어 커버리지가 압도적입니다. 한국어 키워드로는 거의 잡히지 않습니다. 해외 브랜드는 영어(`Leica M6`)도 됩니다. 키워드 1개당 $0.02 |
| `maxItemsPerKeyword` | `100` | 키워드당 표본으로 뽑을 종료 경매 수(30–500, 50 = 1페이지) |
| `soldOnly` | `true` | 개별 명세는 실제 낙찰건만 출력(기본값 ON) |
| `includeIndividualItems` | `true` | **기본값 ON**: 개별 명세도 함께 출력, 건당 +$0.002. 요약만 필요하면 끄세요 |
| `convertToUsd` | `true` | 달러 가격 병기 |

```json
{
    "keywords": ["ポケモンカード リザードン psa10", "ロレックス デイトナ"],
    "maxItemsPerKeyword": 100,
    "includeIndividualItems": true,
    "convertToUsd": true
}
```

자주 쓰는 일본어 키워드 대조표: 포켓몬카드 = `ポケモンカード` / 리자몽 = `リザードン` / 건담 프라모델 = `ガンダム プラモデル` / 롤렉스 데이토나 = `ロレックス デイトナ` / 치이카와 = `ちいかわ` / 필름 카메라 = `フィルムカメラ`.

#### 출력 Output

키워드마다 `price_summary` 한 건:

```json
{
    "type": "price_summary",
    "keyword": "ポケモンカード リザードン psa10",
    "status": "closed_auctions",
    "totalListingsFound": 4879,
    "sampledListings": 100,
    "soldListings": 84,
    "priceJpy": { "min": 1200, "p25": 9250, "median": 24800, "p75": 46500, "max": 158000, "average": 31420 },
    "priceUsd": { "min": 7.4, "p25": 57.4, "median": 153.8, "p75": 288.4, "max": 980.1, "average": 194.9 },
    "bidCountStats": { "min": 1, "p25": 1, "median": 3, "p75": 12, "max": 47, "average": 8 },
    "checkedAt": "2026-07-03T12:00:00+00:00"
}
```

읽는 법: `priceJpy.median`이 **일본 시장의 실제 낙찰 중앙값**이고, 견적은 여기에 앵커를 두면 됩니다. `p25`–`p75`가 정상 가격대이며, `p25`보다 낮게 잡아야 마진이 남습니다. `bidCountStats.median`이 높을수록 경쟁이 치열하다는 뜻이므로 대리 입찰 시 상향 여지를 미리 잡아 두세요. 개별 명세를 켜면 경매 한 건당 `type: "item"` 레코드(제목, 엔/달러 낙찰가, 입찰 수, 상태, 종료 시각, 사진, `auctions.yahoo.co.jp` 직링크)가 추가로 나옵니다.

#### 가격 Pricing

건당 과금이며 구독도 월정액도 없습니다.

| 과금 이벤트 | 가격 | 시점 |
|---|---|---|
| 키워드 시세 요약(`keyword-analyzed`) | **$0.02** | 키워드 1개를 분석할 때마다 |
| 개별 경매 레코드(`item-scraped`) | **$0.002** | 「개별 경매 출력」을 켰을 때만 |

- **이 Actor의 「개별 경매 출력」은 기본값 ON**입니다(원본 Actor의 기본값과 동일). 따라서 기본 실행 비용은 **$0.02 + $0.002 × 실제 출력된 낙찰 건수**입니다. 예를 들어 100건을 표본으로 뽑아 84건이 낙찰이었다면 $0.02 + $0.168 ≈ $0.19.
- 요약만 필요하다면 `includeIndividualItems`를 끄세요. 키워드당 **$0.02 고정**입니다.
- **결과가 0건인 키워드는 과금되지 않습니다.**
- Apify 무료 크레딧은 매월 **$5**이므로 시세 조회를 꽤 많이 돌릴 수 있습니다.

#### 주의사항 Notes

- 키워드는 **일본어**로 넣으세요. 일본 사이트라 한국어 키워드로는 거의 결과가 없습니다.
- **공개된 종료 경매 정보만** 읽고 로그인하지 않습니다. **출력에 판매자 신원 정보는 포함되지 않습니다.**
- 요청은 스로틀링(페이지당 1.5초)되어 있어 야후 옥션에 주는 부하는 무시할 수준입니다.
- LY Corporation(야후 재팬)과 아무 관계가 없습니다. 데이터는 시장 조사용이며 고액 거래 전에는 직접 확인하세요.
- 페이지 구조가 바뀌면 빈 결과를 돌려주는 대신 **명시적으로 실패**합니다. 정상처럼 보이는 빈 데이터를 넘기지 않습니다.
- 메르카리 시세도 함께 보려면 자매 Actor **Mercari Japan Sold Price Checker for Korean Cross-Border Buyers**를 쓰세요.

***

### English

#### Overview

Sold-price statistics from **closed (ended) auctions** on Japan's biggest auction marketplace. One call per keyword returns a ready-to-use comps summary — median, average, quartiles, price range — plus bid-competition statistics, and optionally every sampled auction.

This listing is the **Korean-language package** of our English Actor [Yahoo! Auctions Japan Sold Comps](https://apify.com/jpmarketdata/yahoo-auction-sold-comps). The scraping and statistics are the same; the documentation, store copy and input labels are written for Korean-speaking cross-border buyers (일본 직구 / 구매대행).

#### Input

| Field | Example | Notes |
|---|---|---|
| `keywords` | `["ポケモンカード リザードン psa10"]` | Japanese keywords give the best coverage; English brand names also work. $0.02 per keyword |
| `maxItemsPerKeyword` | `100` | Closed auctions sampled per keyword (30–500) |
| `soldOnly` | `true` | Individual records: only auctions that actually sold |
| `includeIndividualItems` | `true` | On by default — also pushes every sampled auction (+$0.002 each) |
| `convertToUsd` | `true` | Adds USD prices at the current rate |

#### Output

One `price_summary` record per keyword (`priceJpy` / `priceUsd` / `bidCountStats`, `totalListingsFound`, `sampledListings`, `soldListings`, `checkedAt`) — see the JSON example in the Korean section — plus, optionally, one `item` record per sampled auction with title, final price, bids, condition, end time, photo and a direct `auctions.yahoo.co.jp` URL. Statistics are always computed from auctions that actually sold (≥1 bid).

#### Pricing

| Event | Price |
|---|---|
| Keyword sold-price summary (`keyword-analyzed`) | **$0.02** |
| Individual auction record (`item-scraped`) | **$0.002** each |

**Individual records are ON by default here** (matching the source Actor's default), so a default run costs $0.02 + $0.002 per sold auction returned — e.g. 84 sold auctions ≈ $0.19. Turn `includeIndividualItems` off for a flat $0.02 per keyword. Keywords with zero results are never charged. No subscription.

#### Notes

- Reads only publicly visible closed-auction data — no login; **seller identities are excluded** from the output.
- Requests are throttled (1.5 s per page). Works with the [Apify MCP server](https://mcp.apify.com) for AI agents.
- Not affiliated with LY Corporation. Data is for market research; verify before large transactions.
- If the page structure changes, the run **fails loudly** instead of returning a plausible-looking empty result.

***

### 日本語

#### 概要 Overview

ヤフオク!の**終了済みオークション**から、キーワードごとの落札価格統計（中央値・平均・四分位・価格帯）と入札競争度を1コールで返します。韓国語圏の**日本直購・購買代行・転売業者**向けに、韓国語で書き直したパッケージです（英語版は [Yahoo! Auctions Japan Sold Comps](https://apify.com/jpmarketdata/yahoo-auction-sold-comps)、取得・統計処理は同一）。

#### 入力 Input

`keywords`（日本語キーワード推奨）／`maxItemsPerKeyword`（既定 100、30〜500）／`soldOnly`（既定 ON）／`includeIndividualItems`（**既定 ON**）／`convertToUsd`（既定 ON）。

#### 出力 Output

キーワードごとに `price_summary` を1件（`priceJpy` の最小・p25・中央値・p75・最大・平均、`bidCountStats`、`totalListingsFound`、`soldListings`、USD換算）。`includeIndividualItems` が ON のときは、落札された各オークションの明細（タイトル・落札価格・入札数・状態・終了時刻・画像・URL）も出力します。統計は**落札されたもの（入札1件以上）のみ**から計算します。

#### 料金 Pricing

キーワードサマリー（`keyword-analyzed`）**$0.02**／個別レコード（`item-scraped`）**$0.002 / 件**。本 Actor は個別明細が**既定 ON**（ソース Actor の既定値と同じ）のため、既定実行は $0.02 + $0.002 × 落札件数です。`includeIndividualItems` を OFF にすればキーワードあたり $0.02 固定。**0件のキーワードは課金されません。** サブスクリプション不要。

#### 注意 Notes

公開されている終了済みオークション情報のみを読み取り、ログインは行いません。**出品者情報は出力しません。** リクエストは1.5秒間隔に制限しています。LINEヤフー株式会社とは無関係です。データは市場調査用であり、高額取引の前にご自身で確認してください。ページ構造が変わった場合は空データを返さず**明示的にエラー**にします。

# Actor input Schema

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

시세를 조회할 키워드입니다. 여러 개를 한 번에 넣을 수 있습니다(키워드 1개당 $0.02). 되도록 일본어 키워드를 쓰세요. 야후 옥션은 일본 사이트라 일본어 키워드의 커버리지가 가장 높습니다. 예: 「ポケモンカード リザードン psa10」(포켓몬카드 리자몽 PSA10), 「ロレックス デイトナ」(롤렉스 데이토나), 「ガンダム プラモデル」(건담 프라모델). 해외 브랜드는 영어(예: 'Leica M6')로도 검색됩니다. One or more search queries; Japanese keywords give the best coverage, English brand names also work.

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

키워드마다 종료된 경매를 몇 건 표본으로 뽑아 시세를 계산할지 정합니다. 50 = 검색 결과 1페이지. 건수가 많을수록 통계는 안정되지만, 「개별 경매 출력」을 켜 두면 비용도 함께 올라갑니다. How many closed auctions to sample per keyword.

## `soldOnly` (type: `boolean`):

기본값 ON: 실제로 낙찰된 경매(입찰 1회 이상)만 개별 레코드로 출력합니다. 이 설정과 무관하게 통계는 항상 낙찰된 경매만으로 계산합니다. If enabled (default), only auctions that actually sold are pushed as individual records.

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

기본값 ON: 시세 요약과 함께 표본 경매를 한 건씩(제목, 낙찰가, 입찰 수, 상태, 종료 시각, 사진, 링크) 출력합니다. 구매대행 견적을 건별로 검증할 때 유용하며 건당 +$0.002입니다. 요약 한 줄만 필요하면(키워드당 $0.02 고정) 끄세요. If enabled, every sampled auction is also pushed to the dataset.

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

엔화 가격 옆에 실시간 환율(open.er-api.com) 기준 달러 가격을 함께 표시합니다. eBay, 번개장터 등 다른 시장 시세와 비교하기 편합니다. Adds USD prices next to JPY using the current exchange rate.

## Actor input object example

```json
{
  "keywords": [
    "ポケモンカード リザードン psa10"
  ],
  "maxItemsPerKeyword": 100,
  "soldOnly": true,
  "includeIndividualItems": true,
  "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": [
        "ポケモンカード リザードン psa10"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("jpmarketdata/yahoo-auction-comps-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": ["ポケモンカード リザードン psa10"] }

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

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).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": [
    "ポケモンカード リザードン psa10"
  ]
}' |
apify call jpmarketdata/yahoo-auction-comps-kr --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=jpmarketdata/yahoo-auction-comps-kr",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/HledFikwN8pP4iWRQ/builds/MB91eUbiHa5TvMaR8/openapi.json