Ragtag Japan Designer Resale Listings Scraper

Scrapes live listings from RAGTAG Online (ragtag.jp), Japan's largest designer-resale chain with roughly 240,000 active listings. Returns brand, model, condition grade, JPY price, size, color, 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	Seller remarks on the item: flaws, season notes, line markers (Japanese)
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)
price_excl_tax_jpy	Selling price in JPY excluding consumption tax (new field)
base_price_jpy	RAGTAG base price in JPY (not a retail price; can be above or below price_jpy)
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
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 or category and read the condition field to understand supply depth

Input

Field	Type	Required	Description
maxItems	integer	Yes	Maximum records to return (use 10–15 for testing; set 0 for no limit / the 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 (maxItems: 0 = no limit):

{
  "maxItems": 0,
  "category_id": "SH2C"
}

How it works

The actor calls RAGTAG's public item-search JSON API at /api/v1/item/search/json. 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: roughly 2,430 pages of 100 listings, paced at about 2 requests per second. Set maxItems to 0 for an unlimited run.

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 is RAGTAG's base price for the item; it is not a retail price, so do not use it as a markdown baseline.

Condition grades

RAGTAG uses a proprietary grading system from best to worst:

Grade	Meaning
S	Like new / unused
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).
• Only in-stock listings are returned: RAGTAG's search feed does not serve sold-out items, so there is no availability field. Items sell quickly, so run-to-run freshness matters for arbitrage use cases.
• RAGTAG's feed carries no review data (review counts and scores were 0 on every one of 1,600+ sampled listings), so those fields were removed.
• Filtering by brand_id also returns RAGTAG's sub-brand ids that share the same brand name (for example 03270 alongside 01016, both BEAMS).
• sale_starts_at is RAGTAG's listing/sale date stamp and is present on regular listings too, not only items on sale.
• Color names are in Japanese. Common mappings: 赤=red, 黒=black, 白=white, 青=blue, 茶=brown, グレー=gray, ベージュ=beige, ピンク=pink.