Mercari Listings Scraper

Extract Mercari product listings from search queries, search URLs, item IDs, and seller shop URLs. The actor is built for resale market monitoring, sold-comp collection, deal discovery, and inventory tracking workflows.

Mercari search is a browser-rendered Next.js experience. The actor uses a real browser, waits for Mercari's hydrated XHR responses, extracts structured listing data from the JSON payload when available, and falls back to rendered listing cards when network payload capture is unavailable. It is read-only and does not sign in, like, follow, buy, offer, message, or add anything to a cart.

Features

• Search one or many Mercari keywords.
• Accept direct Mercari search, category, item, and seller URLs.
• Hydrate item IDs into current item status and price rows.
• Extract seller inventory from numeric /u/{sellerId} pages and resolve username profile URLs when Mercari exposes the member ID.
• Supports category, brand ID, condition, price, shipping payer, status, offerable, local pickup, authenticate, and sort filters.
• Captures price, status, condition, brand, size, color, seller, shipping, likes, images, timestamps, and canonical listing URLs when available.
• Saves SUMMARY, SEARCH_SPECS, and FAILED_TARGETS records to key-value storage.
• Defaults to US residential Apify proxy because Mercari's public web app relies on browser-minted session state.

Example Input

{
  "queries": ["coach bag"],
  "priceMin": 50,
  "priceMax": 300,
  "maxItems": 25,
  "pageSize": 60,
  "proxyConfig": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "US"
  }
}

URL And Watchlist Input

{
  "startUrls": [
    { "url": "https://www.mercari.com/search/?keyword=lululemon%20align&priceMax=60" },
    { "url": "https://www.mercari.com/u/242666380/" }
  ],
  "itemIds": ["m12345678901"],
  "maxItems": 50,
  "includeDetails": false
}

Output

Each dataset row is either a listing row or a diagnostic row. Listing rows include normalized fields such as:

• itemId, url, title, priceUsd, priceText
• condition, brand, size, color, category
• sellerId, sellerUsername, sellerRating, sellerReviewCount, sellerVerified
• shippingPayer, shippingType, shippingCostUsd, freeShipping, shipFromZip
• primaryImageUrl, imageUrls, listingStatus, likeCount
• mercariAuthenticate, smartPricing, offerable, localPickup
• createdTime, updatedTime, listedRelative, scrapedAt

Example Output

{
  "type": "listing",
  "source": "mercari",
  "status": "ok",
  "mode": "search",
  "query": "coach bag",
  "searchUrl": "https://www.mercari.com/search/?keyword=coach%20bag",
  "itemId": "m12345678901",
  "url": "https://www.mercari.com/us/item/m12345678901/",
  "title": "Vintage Y2K Mini Bag Shoulder Bag - Coach",
  "priceUsd": 68.37,
  "priceText": "$68.37",
  "brand": "Coach",
  "primaryImageUrl": "https://u-mercari-images.mercdn.net/photos/m12345678901_1.jpg",
  "listingStatus": "on_sale",
  "likeCount": 14,
  "scrapedAt": "2026-06-01T08:00:00.000Z"
}

Pricing

This actor uses pay-per-event pricing. The primary charge is $4.75 per 1,000 emitted listing rows.

• listing-extracted: charged once per listing row emitted to the default dataset.
• search-page-loaded: charged once per successful Mercari search page replay or browser page.
• seller-page-loaded: charged once per successful seller shop page.
• item-detail-hydrated: charged once per item detail page opened when includeDetails is enabled.

Platform usage is passed through with pay-per-event pricing so browser and residential-proxy costs remain transparent on small or proxy-heavy runs.

Limitations

• Mercari filter IDs for categories, brands, subcategories, colors, sizes, and status can change across builds. Numeric IDs should be discovered from the live Mercari filter UI before large runs.
• Mercari uses bot-management cookies and session-bound XHR auth. Runs should use US residential proxies and low concurrency.
• Seller pages use scroll loading, so very large shops take longer than regular search pagination. Numeric seller URLs are most reliable; username profile URLs are resolved when the page exposes a member ID.
• The actor does not sign in and cannot access account-only data, buyer messages, checkout, saved searches, private likes, or seller dashboard data.
• The actor is read-only and never clicks Buy Now, Make Offer, Add to Cart, Like, Follow, or Sign In.