Mercari Listings Scraper

Mercari Listings Scraper

Extract product listings from Mercari Japan — the largest Japanese marketplace. Fast, reliable, and requires no browser or proxy.

Features

• Rich Filters: Search by keyword, category, brand, price range, item condition, and shipping payer
• Detail Enrichment: Optionally fetch full item details including description, seller ratings, and high-res photos
• Fast Pagination: Automatic pagination through large result sets
• Pay-Per-Event Pricing: Only pay for what you scrape — no wasted compute

How It Works

1. Enter a search keyword and optional filters (category, price range, etc.)
2. Run the scraper — it searches Mercari and paginates through results
3. Optionally enable detail mode to enrich each listing with full description and seller info

Input

Parameter	Type	Required	Default	Description
keyword	string	Yes	—	Search keyword (English and Japanese supported)
categoryId	integer	No	—	Mercari category ID to filter by
brandId	integer	No	—	Mercari brand ID to filter by
itemConditionId	integer[]	No	—	Item condition filter (1=New, 2=Like New, 3=Good, 4=Fair, 5=Poor, 6=Bad)
shippingPayerId	integer[]	No	—	Shipping payer filter (1=Seller, 2=Buyer)
priceMin	integer	No	0	Minimum price in JPY
priceMax	integer	No	0	Maximum price in JPY (0 = no limit)
itemStatus	string[]	No	["STATUS_ON_SALE"]	Item status filter (STATUS_ON_SALE, STATUS_TRADING, STATUS_SOLD_OUT)
sortBy	string	No	SORT_CREATED_TIME	Sort field (SORT_CREATED_TIME, SORT_PRICE, SORT_NUM_LIKES, SORT_SCORE)
sortOrder	string	No	ORDER_DESC	Sort direction (ORDER_DESC, ORDER_ASC)
maxItems	integer	No	100	Maximum number of items to scrape (up to 15,000)
fetchItemDetails	boolean	No	false	Fetch full item details (description, seller info, high-res photos)

Pricing

This Actor uses a pay-per-event pricing model. You only pay for the data you collect.

Event	Price per result	Price per 1,000	Description
Listing result	$0.002	$2.00	Basic listing data from search (name, price, status, thumbnails, brand)
Item detail enrichment	$0.004	$4.00	Full detail fetch adding description, seller ratings, and high-res photos

Examples:

• 1,000 listings (search only): $2.00
• 1,000 listings with full details: $6.00 ($2.00 listing + $4.00 detail)

Sample Output Data

Search mode (default)

[
    {
        "id": "m17108645847",
        "name": "Nintendo Switch2 ソフト 2本セット",
        "price": "15080",
        "status": "ITEM_STATUS_ON_SALE",
        "thumbnails": [
            "https://static.mercdn.net/thumb/item/webp/m17108645847_1.jpg"
        ],
        "categoryId": 0,
        "itemConditionId": "1",
        "shippingPayerId": "2",
        "sellerId": "614470169",
        "itemType": "ITEM_TYPE_MERCARI",
        "created": "1772995134",
        "updated": "1772995134",
        "url": "https://jp.mercari.com/item/m17108645847"
    }
]

Detail mode (fetchItemDetails: true)

[
    {
        "id": "m64547526481",
        "name": "iPhone15 超強化 ガラスフィルム",
        "price": 598,
        "status": "on_sale",
        "description": "商品をご覧いただき誠にありがとうございます...",
        "photos": [
            "https://static.mercdn.net/item/detail/orig/photos/m64547526481_1.jpg"
        ],
        "categoryId": 0,
        "itemConditionId": 0,
        "shippingPayerId": 0,
        "shippingMethodId": 0,
        "sellerId": 614470169,
        "sellerName": "ぴっぴ",
        "sellerRatingScore": 0,
        "sellerRatings": {
            "good": 10660,
            "normal": 1,
            "bad": 10
        },
        "sellerIsVerified": false,
        "brandName": null,
        "itemType": "ITEM_TYPE_MERCARI",
        "created": 1772995134,
        "updated": 1772995134,
        "url": "https://jp.mercari.com/item/m64547526481"
    }
]