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
• Seller Inventory: Paste Mercari Japan seller profile URLs to get each seller's listings plus a profile row with ratings, star score and identity-verified badge
• 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. Or paste seller profile URLs instead of a keyword to scrape those sellers' shops
4. 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). *Not needed when sellerUrls is set
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)
sellerUrls	string[]	No	—	Seller profile URLs (https://jp.mercari.com/user/profile/<id>) or bare IDs, max 100. Replaces the keyword search
inventoryScope	string	No	on_sale	on_sale = active listings; all_public = active + in-trade + sold listings the profile shows
maxItemsPerSeller	integer	No	100	Listing cap per seller (0 = profile only)
includeSellerProfiles	boolean	No	true	Add one profile row per seller
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.004	$4.00	Basic listing data from search or a seller's shop (name, price, status, thumbnails, brand)
Item detail	$0.008	$8.00	Full listing with description, seller ratings, and high-res photos — charged instead of the listing result
Seller profile	$0.01	$10.00	One seller profile row in seller mode (ratings, star score, identity badge, inventory completeness)

Examples:

• 1,000 listings (search only): $4.00
• 1,000 listings with full details: $8.00
• 10 sellers × 100 active listings with profiles: $4.10 ($0.10 profiles + $4.00 listings)

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": 5,
        "sellerNumRatings": 10671,
        "sellerRatings": {
            "good": 10660,
            "normal": 1,
            "bad": 10
        },
        "sellerIsVerified": true,
        "brandName": null,
        "itemType": "ITEM_TYPE_MERCARI",
        "created": 1772995134,
        "updated": 1772995134,
        "url": "https://jp.mercari.com/item/m64547526481"
    }
]

Seller mode (sellerUrls)

Each seller's listings (same fields as search mode, plus recordType: "listing"), followed by one profile row:

{
    "recordType": "sellerProfile",
    "sellerId": "377235154",
    "sellerName": "♛はる➷",
    "url": "https://jp.mercari.com/user/profile/377235154",
    "reportedListingCount": 74,
    "ratingCount": 76,
    "starRatingScore": 4.5,
    "ratings": { "good": 71, "normal": 3, "bad": 2 },
    "polarizedRatings": { "good": 74, "bad": 2 },
    "followerCount": 2,
    "isOfficial": false,
    "memberSince": "1583975704",
    "identityVerifiedBadge": true,
    "inventoryScope": "on_sale",
    "inventoryFetchedCount": 25,
    "inventoryPaginationComplete": true,
    "inventoryStopReason": "terminal",
    "observedAt": "2026-09-22T12:26:54.255Z"
}

• reportedListingCount is the total Mercari shows on the profile. It is not the number of listings currently for sale and not a sales count — compare it with inventoryFetchedCount.
• inventoryPaginationComplete: true means the seller's public feed was read to the end in this run (inventoryStopReason is terminal); item_limit means maxItemsPerSeller stopped it.
• identityVerifiedBadge is null when the badge lookup failed — unknown, not "unverified".
• A seller that doesn't exist yields a row with an error field instead of failing the whole run.
• Mercari Shops storefronts and Mercari US are not supported.