PayPay Flea Market Japan Listings Scraper

Scrape listings from PayPay Flea Market (Yahoo! フリマ), Japan's second-largest C2C resale marketplace operated by SoftBank/Yahoo Japan. Returns clean, fully typed listing records — fast, cheap, and stable across redesigns.

What it does

• Searches PayPay Flea Market by keyword or category
• Returns up to 100 listings per page, fully typed
• Paginates automatically until maxItems is reached
• Returns rich structured data including price, condition, category path, seller info, and image URLs

Use cases

• Price research — compare PayPay Flea Market prices against Mercari, Yahoo Auctions, or Rakuten Flea Market for arbitrage analysis
• Market monitoring — track listing counts, price trends, and availability for specific items
• Seller analysis — identify active sellers with high ratings for resale intelligence
• Inventory discovery — enumerate listings in a category to feed sourcing pipelines

Input

Field	Type	Description	Default
query	string	Search keyword or category name (e.g. camera, iphone, nike)	camera
maxItems	integer	Maximum number of listings to return	10

Output

Each record contains:

Field	Description
item_id	Unique listing identifier (e.g. z613570742)
title	Listing title
price_jpy	Price in Japanese yen
item_status	OPEN or sold
category_path	Full category breadcrumb (e.g. カメラ > フィルムカメラ)
condition	new, used10, used20, used40, or used60
seller_id	Seller account ID
seller_rating	Seller positive review ratio (0-100)
shipping_payer	null (not available in the search layer)
item_url	Direct link to the listing page
image_urls	Array of image URLs
posted_at	ISO 8601 timestamp when the listing was posted

Notes

• Fields come back clean and consistently typed, not scraped from page text
• shipping_payer is not available from the search result layer (PayPay Flea Market includes it only on individual item pages)
• condition uses PayPay internal grade scale: used10 = like-new, used20 = excellent, used40 = good, used60 = fair
• Broad queries (e.g. camera) return 100,000+ results — use maxItems to cap output

Example

Input:

{
  "query": "nintendo switch",
  "maxItems": 50
}

Output (excerpt):

{
  "item_id": "z619284523",
  "title": "Nintendo Switch 本体 Joy-Con グレー",
  "price_jpy": 22000,
  "item_status": "OPEN",
  "category_path": "テレビゲーム > Nintendo Switch > 本体",
  "condition": "used20",
  "seller_id": "p38124091",
  "seller_rating": 98,
  "shipping_payer": null,
  "item_url": "https://paypayfleamarket.yahoo.co.jp/item/z619284523",
  "image_urls": ["https://auc-pctr.c.yimg.jp/..."],
  "posted_at": "2026-06-05T10:30:00+09:00"
}