RAGTAG Japan Designer Resale Listings Scraper

Scrapes live listings from RAGTAG Online (ragtag.jp), Japan's largest designer-resale chain with ~246,000 active listings. Returns brand, model, condition grade, JPY price, size, color, sold-out status, and bilingual brand fields — the data backbone for JP→US/EU luxury arbitrage analysis and cross-border designer-resale price comparisons.

What you get

Each record covers one RAGTAG listing:

Field	Description
`listing_id`	RAGTAG item code (e.g. `3601425N0056`)
`title`	Full listing title (Japanese, e.g. `VANS スニーカー`)
`brand`	Brand name in Latin script (e.g. `VANS`, `CHANEL`, `HERMES`)
`brand_kana`	Brand name in Japanese kana (e.g. `バンズ`)
`brand_id`	RAGTAG internal brand code — links to `/brand/<id>/` pages
`product_type`	Category name in Japanese (e.g. `スニーカー`, `バッグ`)
`category_id`	RAGTAG category code (e.g. `FW5C` for sneakers, `SH2C` for bags)
`model`	Model/description extracted from title (brand prefix stripped)
`sub_reference`	Collab or line markers (e.g. `× RONHERMAN`)
`condition`	RAGTAG condition grade: `S` / `A` / `AB` / `B` / `BC` / `C` / `CD` / `D`
`color`	Color in Japanese (e.g. `赤` for red, `黒` for black)
`size`	Size as listed (e.g. `26.5cm`, `M`, `36`)
`price_jpy`	Current selling price in JPY (low end)
`price_high_jpy`	Selling price high end (equals `price_jpy` when single price)
`base_price_jpy`	Original / list price before markdown
`available`	`true` if in stock; `false` if sold out
`is_new_arrival`	`true` if flagged as new arrival
`is_sale`	`true` if on sale
`sale_starts_at`	Sale start datetime (format `YYYYMMDDHHmmss`)
`season`	Season code (e.g. `25N` for 2025 new season)
`display_tags`	All display tags including condition, season, material tags
`product_url`	Full URL to the listing on ragtag.jp
`image_url`	Full URL to the primary listing image
`review_count`	Number of reviews
`review_score`	Review score (0–5)
`scraped_at`	ISO 8601 timestamp of when the record was scraped

Use cases

Cross-border luxury arbitrage: Model the JPY→USD/EUR price gap on the same brand/model/condition across RAGTAG (JP), Fashionphile, Rebag (US), and Hardly Ever Worn It (UK)
Brand secondary-market analysis: Track how specific brands move through the Japanese pre-owned market — pricing, condition distribution, sell-through velocity
Price monitoring: Track JPY prices over time for specific brands, models, or condition grades
Authentication/appraisal: Calibrate Japanese-market pricing for authentication services
Inventory research: Filter by brand code, category, or condition to understand supply depth

Input

Field	Type	Required	Description
`maxItems`	integer	Yes	Maximum records to return (use 10–15 for testing; omit for full catalog)
`brand_id`	string	No	Optional RAGTAG brand code to filter results (e.g. `01016` for BEAMS). Leave blank to scrape all brands.
`category_id`	string	No	Optional RAGTAG category code to filter results (e.g. `FW5C` for sneakers, `SH2C` for bags). Leave blank to scrape all categories.

Example inputs

Scrape 100 CHANEL listings:

{
  "maxItems": 100,
  "brand_id": "00001"
}

Scrape all handbags (no maxItems cap = full catalog):

{
  "category_id": "SH2C"
}

How it works

The actor calls RAGTAG's public item-search JSON API at /api/v1/item/search/json — no HTML parsing, no browser rendering, no proxy required. It paginates through results (100 items per page) until the catalog is exhausted or maxItems is reached. Optional brand and category filters reduce the page count for targeted runs.

Full catalog run: ~2,450 pages × 100 items = ~245,000 listings at 2 requests/sec ≈ a few hours.

Pricing note

All prices are in Japanese Yen (JPY). For cross-border comparison, apply current JPY/USD or JPY/EUR exchange rates. The base_price_jpy field shows the original list price — useful for computing the markdown percentage relative to retail.

Condition grades

RAGTAG uses a proprietary grading system from best to worst:

Grade	Meaning
`S`	Unused / mint condition
`A`	Near-mint, minimal signs of use
`AB`	Between A and B
`B`	Light use, normal wear
`BC`	Between B and C
`C`	Visible wear
`CD`	Between C and D
`D`	Heavy wear, significant flaws

Notes

Content is in Japanese (UTF-8). Brand names are available in both Latin (brand) and kana (brand_kana).
The available flag reflects RAGTAG's soFlg (sold-out flag) at scrape time. Items sell quickly — run-to-run freshness matters for arbitrage use cases.
Color names are in Japanese. Common mappings: 赤=red, 黒=black, 白=white, 青=blue, 茶=brown, グレー=gray, ベージュ=beige, ピンク=pink.

Ragtag Japan Designer Resale Listings Scraper