Simple keyword searches, one per line — brand names, item types, model numbers, Japanese or English (e.g. KAPITAL, リーバイス 501, Porter タンカー). Each keyword is one search and inherits the defaults below. Optional when searches is set.
Type:array
Default:
[]
Structured searches
searches
Optional
Advanced searches as JSON objects. Every field is optional, but each search needs at least one of keyword, brand, brandId, categoryPath, categoryId.
keyword — free text (site keyword search).
brand — brand name as listed on Rakuma (e.g. KAPITAL, COMME des GARCONS); resolved to the site's brand id through one keyword search. brandId — that id directly (1785 = KAPITAL).
categoryPath — mens, ladies, kids, or a path such as mens > jackets, メンズ > パンツ > デニム/ジーンズ, ladies > バッグ; categoryId — the site's category id (542 = メンズ > ジャケット/アウター > Gジャン/デニムジャケット).
priceMinJpy / priceMaxJpy — price bounds (client-side; the site's price filter is robots-disallowed).
conditionMin — minimum condition rank 2–6 (6 = 新品、未使用, 5 = 未使用に近い, 4 = 目立った傷や汚れなし, 3 = やや傷や汚れあり, 2 = 傷や汚れあり). Needs the item page, so it turns on enrichDetail.
status — on_sale (default), sold (sold-out listings only — price research), all.
excludeWords — drop items whose title contains any of these (client-side).
sellerId — keep only one seller's items (client-side).
A keyword combined with a brand or category runs the keyword search and filters the cards by brand / category client-side (the site's brand_id / category_id query parameters are robots-disallowed). Without a keyword the brand page, brand × category page or category page is crawled directly.
Values set here override the defaults below.
Type:object[]
Default:
[]
Output mode
outputMode
Optional
items (default): one dataset row per listing. summary: one market-summary row per search instead of the listings — sample size, price min / p25 / median / mean / p75 / max, price histogram, status / condition-rank / size / brand / category breakdowns, cheapest listings — billed once per search as the summary event (the sampled listings are not billed). both: listings plus the summary row.
Type:string
Default:items
Options:
itemssummaryboth
Default status
status
Optional
Applied to every search without its own status. sold returns sold-out listings with their last price (price research); the site shows them in the same listing.
Type:string
Default:on_sale
Options:
on_salesoldall
Default min price (JPY)
priceMinJpy
Optional
Lower price bound for every search without its own priceMinJpy (client-side).
Type:integer
Minimum:0
Default max price (JPY)
priceMaxJpy
Optional
Upper price bound for every search without its own priceMaxJpy (client-side).
Type:integer
Minimum:0
Default min condition rank
conditionMin
Optional
Only listings with this condition rank or better: 6 新品、未使用, 5 未使用に近い, 4 目立った傷や汚れなし, 3 やや傷や汚れあり, 2 傷や汚れあり. The condition is only on the item page, so this turns on item-page enrichment. Leave empty for all.
Type:integer
Minimum:2
Maximum:6
Default exclude words (client-side)
excludeWords
Optional
Drop items whose title contains any of these words (case-insensitive).
Type:array
Default:
[]
Max items per search
maxItemsPerSearch
Optional
Stop after this many listings for each keyword / search. The site shows 40 listings per page, up to 100 pages.
Type:integer
Minimum:1
Maximum:4000
Default:100
Max total items
maxTotalItems
Optional
Hard cap on listings saved in this run across all searches. Leave empty for no cap (Max total charge still applies).
Type:integer
Minimum:1
Deduplicate across searches
dedupeAcrossSearches
Optional
Save a listing only once when several searches return it.
Type:boolean
Default:true
Enrich with item pages
enrichDetail
Optional
Open each item page for condition, size, shipping (payer, method, days, prefecture), seller (name, shop, review counts), likes, comments, description, full category path and the full-size gallery. One extra request and one detail-page event per item.
Type:boolean
Default:false
Max item pages per run
maxDetailPages
Optional
Cap on item-page requests per run. Items beyond the cap are returned without detail fields.
Type:integer
Minimum:0
Maximum:5000
Default:100
Delay between requests (ms)
requestDelayMs
Optional
Minimum pause between requests. Please keep ≥ 2000.
Type:integer
Minimum:1000
Maximum:60000
Default:2000
Proxy configuration
proxyConfiguration
Optional
Optional Apify Proxy or your own proxies. Not needed under normal use.
Type:object
Output fields
outputFields
Optional
Keep only these top-level fields in the output (itemId and url are always kept). Leave empty for all fields.