# PayPay Flea Market Japan Price Checker — Market Stats (`jpmarketdata/paypay-flea-price-checker`) Actor

Get instant price statistics (median, average, range) plus like-count demand signals from PayPay Flea Market, Japan's #2 flea market app. One call answers: what is this item going for?

- **URL**: https://apify.com/jpmarketdata/paypay-flea-price-checker.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 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

## PayPay Flea Market Japan Price Checker — Market Stats

**One call answers: "What is this item going for on PayPay Flea Market — and does anyone want it?"**

Instead of dumping raw listings on you, this Actor samples live listings for your keywords on PayPay Flea Market (PayPayフリマ) and returns a ready-to-use price summary — median, average, quartiles, price range — plus a **demand-heat signal** (like-count statistics), and the individual listings if you want them.

**Try it free in 30 seconds:** hit *Start* with the prefilled example — one keyword costs a flat **$0.02**, covered many times over by the **$5 free usage credit** every Apify account gets each month.

### 日本語ガイド — PayPayフリマの相場を1コールで

**概要**: PayPayフリマの出品中商品をキーワード検索し、価格の統計 — 中央値・平均・四分位・価格帯(円+ドル換算)— と「いいね数」の統計(需要の強さのシグナル)を JSON で返します。出品前の値付け、仕入れ判断、[メルカリ相場チェッカー](https://apify.com/jpmarketdata/mercari-japan-price-checker)と組み合わせたフリマ間の価格差チェックに使えます。

**使い方**: 入力欄にキーワードを入れて *Start* を押すだけ。日本語キーワードが最も精度が高く、複数キーワードの一括チェックもできます。

```json
{
    "keywords": ["ポケモンカード リザードン psa10"],
    "maxItemsPerKeyword": 100,
    "convertToUsd": true
}
```

**料金**: 1キーワードあたり **$0.02(約3円)** の従量課金で、サブスクリプションや月額固定費はありません。個別の出品一覧(タイトル・価格・いいね数・URL 付き)も欲しい場合は *Include individual listings* をオンにすると +$0.002/件。結果が0件のキーワードには課金されません。Apify の無料プランには**毎月 $5 分の無料クレジット**が付くので、月250回程度の相場チェックまで実質無料です。

### Why PayPay Flea Market?

PayPayフリマ is Japan's #2 flea-market app (LY Corporation), full of trading cards, anime figures, retro games, cameras, and fashion — often priced differently from Mercari for the exact same item. This Actor turns one keyword into structured market intelligence:

- **Price before you buy or sell** — median and quartiles from real live listings, JPY + USD
- **Cross-check Mercari** — pairs with our [Mercari Japan Price Checker](https://apify.com/jpmarketdata/mercari-japan-price-checker) to spot inter-marketplace gaps inside Japan
- **Read demand** — like-count stats show what actually attracts buyers
- **Feed your AI agent or spreadsheet** — clean JSON

### Pricing — know your cost before you run

No subscription, no monthly rental — you pay per call:

| Event | Price |
|---|---|
| Price summary (one per keyword) | **$0.02** |
| Individual listing record (optional, off by default) | $0.002 each |

- **A default run costs a flat $0.02 per keyword** — the summary is the product. 10 keywords = $0.20.
- Want the raw listings too? Turn on *Include individual listings*: e.g. 100 listings add $0.20.
- Keywords with zero results are never charged.
- Apify's free plan includes **$5 of usage credit every month** — about **250 price checks** at no cost. Most scrapers rent by the month; here an occasional price check costs cents.

### Input example

```json
{
    "keywords": ["ポケモンカード リザードン psa10", "Leica M6"],
    "maxItemsPerKeyword": 100,
    "convertToUsd": true
}
```

### Output

One `price_summary` record per keyword:

```json
{
    "type": "price_summary",
    "keyword": "ポケモンカード リザードン psa10",
    "status": "on_sale",
    "totalListingsFound": 23738,
    "sampledListings": 100,
    "priceJpy": { "min": 1500, "p25": 8800, "median": 19800, "p75": 42000, "max": 171999, "average": 28900 },
    "priceUsd": { "min": 9.3, "p25": 54.6, "median": 122.8, "p75": 260.5, "max": 1066.8, "average": 179.3 },
    "likeCountStats": { "min": 0, "p25": 1, "median": 4, "p75": 12, "max": 96, "average": 9 },
    "checkedAt": "2026-07-03T12:00:00+00:00"
}
```

Plus (optional) every sampled listing with title, price (JPY + USD), condition, likes, listing date, photo, and a direct paypayfleamarket.yahoo.co.jp URL.

Note: the public search returns **live listings only**, so statistics reflect asking prices. Like counts are your demand signal.

### Use with AI agents

Works out of the box with the [Apify MCP server](https://mcp.apify.com), so Claude, ChatGPT, and other MCP-enabled agents can check Japanese market prices autonomously.

### Fair use & data

- Reads only **publicly visible listing data** — no login; seller identities are excluded from the output
- Requests are throttled to keep the load on the site negligible
- Not affiliated with LY Corporation. Data is provided for market research; verify before large transactions

### Roadmap

Sold-listing statistics, category filters, and Mercari cross-market comparison in one call. Feedback via issues is very welcome.

# Actor input Schema

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

One or more search queries. Japanese keywords give the best coverage (e.g. 'ポケモンカード リザードン psa10'), but English brand names also work.

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

How many live listings to sample per keyword. 100 = one result page. More items = better statistics. Affects cost only when 'Include individual listings' is enabled (+$0.002 per listing).

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

Off by default: a run costs a flat $0.02 per keyword (price summary only). Enable to also get every sampled listing (title, price, condition, likes, listing date, URL, photo) at +$0.002 per listing.

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

Adds USD prices next to JPY using the current exchange rate (open.er-api.com).

## Actor input object example

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

// Run the Actor and wait for it to finish
const run = await client.actor("jpmarketdata/paypay-flea-price-checker").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/paypay-flea-price-checker").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/paypay-flea-price-checker --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=jpmarketdata/paypay-flea-price-checker",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/8lImxoky5Ph9a3XjU/builds/enXiqOnWouPwcfRcJ/openapi.json