Mercari US Scraper
Extract product listings from Mercari US with titles, prices, images, seller profiles, condition, shipping details, and full detail page enrichment.
Changelog
v1.1 (July 2026)
- New: Scrape Category mode — browse Mercari's full category tree (T1/T2/T3) and scrape entire categories automatically with a built-in category database.
- New: Filters panel — filter by item status (on sale / sold), price range, and condition (Pro).
- New: Image download — save product images to your Downloads folder as the scraper runs (Pro).
- New: Built-in category database builder — discovers all Mercari US categories and subcategories with one click.
- Improved: Detail page enrichment now extracts 30+ fields including seller profile, shipping details, item specifics, and all images.
- Improved: Auto-scroll with smart footer detection — automatically stops when the page bottom is reached.
- Improved: Concurrent tab processing for faster detail page scraping (configurable up to 5 tabs).
- Improved: CSV export with cleaner formatting and proper field escaping.
- Fixed: Better "View More" button detection and click handling.
- Fixed: More reliable ld+json structured data extraction for titles, prices, and conditions.
- Fixed: Sold badge detection now checks both DOM and __NEXT_DATA__ server state.
v1.0 (June 2026)
- Initial release — scrape current Mercari US search and listing pages.
- Auto-scroll to load more products.
- Basic fields: title, price, image, condition, sold status.
- Free tier: 500 items, current page only.
- Pro: unlimited items, detail page enrichment, CSV export.
1. Overview
What this scraper can do:
- Scrape product listings from any Mercari US page — search results, seller profiles, collections, or category pages.
- Browse and scrape categories — select T1/T2/T3 categories from a built-in database and scrape them automatically.
- Auto-scroll to load more products as you scroll, with smart detection of page end.
- Scrape detail pages (Pro) — opens each listing in its own tab to collect the full item description, all images, seller profile, shipping details, posted date, and more — 30+ columns in the CSV.
- Apply filters (Pro) — filter by item status (on sale, sold), price range, and condition.
- Export all data to CSV for analysis in Excel or Google Sheets.
- Download images (Pro) — saves product images to your Downloads folder as the scraper runs.
Target site: https://www.mercari.com/us/ — Mercari US marketplace for secondhand and new goods across fashion, electronics, collectibles, home, and more.
3. Installation & First Launch
- Open Chrome and navigate to
chrome://extensions. - Enable Developer mode (top-right toggle).
- Click Load unpacked and select the extracted extension folder.
- Pin the extension icon for easy access.
- Open
https://www.mercari.com/us/in a tab first (to warm DNS/cookies). - Click the extension icon, adjust settings if needed, and click Start.
Important: The extension requires host permissions for
www.mercari.com. Grant these when prompted.4. How It Works
The scraper uses a tab-based batch processing strategy:
- Opens Mercari in a background tab and detects the page type (search, category, seller profile, or detail page).
- Extracts all visible listing tiles from the page using
data-testidselectors and embeddedld+jsonstructured data. - Scrolls down row by row to trigger lazy loading, collecting new items as they appear.
- Detects the View More button and clicks it when visible to load additional items.
- Continues scrolling until no new items load or the footer becomes visible (page end).
- If Scrape detail pages is enabled (Pro), opens each collected item URL in its own tab to extract full detail fields.
5. Controls
| Button | Action |
|---|---|
| Start | Begins a fresh scrape from scratch (clears previous records). |
| Pause | Suspends scraping after the current batch finishes. All collected data is preserved. |
| Resume | Continues scraping from where it was paused. |
| Stop | Immediately halts the scraper and closes all open scraper tabs. Collected data is preserved. |
| Export CSV | Downloads all scraped records as a CSV file with all fields as columns. |
| Clear Data | Empties all stored scraped records from the extension. |
| Activate Pro | Opens the license activation panel where you paste your Pro license key. |
6. Settings Reference
| Setting | Default | Description |
|---|---|---|
| Scroll to load more | On | Automatically scrolls the page to trigger lazy loading of additional products. Recommended to keep on. |
| Scrape detail pages | Off (Pro) | Opens each listing to collect the full item description, all images, seller profile, shipping details, and more. Pro only. |
| Download images | Off (Pro) | Saves product images to your Downloads folder as the scraper runs. Pro only. |
| Max concurrent tabs | 3 | Number of detail pages to process simultaneously. Higher values complete faster but use more system resources. |
| Scroll delay min/max | 600 / 1500 ms | Random delay range between scroll actions to mimic human browsing behaviour. Helps avoid rate limiting. |
| Scroll step | 200 px | Pixels to scroll per step. Smaller values are smoother but slower. |
7. Scrape Modes
Current Page
Scrapes whatever Mercari page is open in your active tab — search results, a seller's profile, a collection, or any listing grid. The scraper uses whatever is already loaded and scrolls for more items.
Scrape Category (Pro)
Select one or more full product categories from Mercari's navigation tree. The scraper visits each category URL automatically, scrolls through all listings, collects item data, then moves to the next category. Supports T1/T2/T3 depth with optional filters.
8. Extracted Data Fields
The scraper extracts the following fields from each product. Fields marked with * are only available with detail page scraping (Pro).
| Field | Description | Source |
|---|---|---|
| Title | Product listing title | ld+json / ItemName element |
| Price | Listing price (numeric only) | ld+json / ItemPrice element |
| Currency | Currency code (e.g. USD) | ld+json |
| Image URL | Primary product thumbnail | Image element from mercdn.net |
| All Images | All image URLs for this listing * | Detail page image elements |
| Item URL | Direct link to the product page | Anchor href |
| Item ID | Unique Mercari item ID (mXXXXX) | Extracted from URL |
| Condition | Item condition (e.g. Used - Like New) | ld+json / itemSpecifics |
| Brand | Product brand * | Detail page brand element |
| Description | Full item description * | Detail page description element |
| Category | Category breadcrumb path * | Detail page breadcrumb / __NEXT_DATA__ |
| Is Sold | Whether the item has been sold | SoldBadge / ld+json availability |
| Is On Hold | Whether the item is on hold | OnHoldBadge |
| Is Authenticated | Whether the item is Mercari Authenticated | AuthenticatedBadge |
| Has Price Drop | Whether the item has a price reduction | PriceDropBadge |
| Seller Name | Seller's display name * | Detail page seller element |
| Seller Username | Seller's @username * | Detail page seller element |
| Seller Rating | Average star rating * | ReviewStarsWrapper |
| Seller Reviews | Number of reviews * | SellerRatingCount |
| Seller Sales | Number of completed sales * | NumSales element |
| Seller Listed | Number of items listed * | NumSellItems element |
| Seller Verified | Whether seller identity is verified * | VerifiedProfile / icn-verified |
| Seller Logo | Seller profile photo URL * | Profile photo image |
| Seller Profile Link | Link to seller's Mercari profile * | View Profile button href |
| Shipping Payer | Who pays for shipping * | ld+json shippingDetails |
| Return Policy | Return policy description * | ld+json hasMerchantReturnPolicy |
| Size | Item size attribute * | ItemDetailsSize element |
| Color | Item color attribute * | itemSpecifics |
| Posted Date | Date the item was listed * | ItemDetailsPosted / __NEXT_DATA__ |
| Delivery From | Shipping origin location * | MobileShippingAndPaymentsAreaName |
| Delivery Shipping | Shipping cost description * | ShippingText element |
| Delivery Payments | Accepted payment methods * | CardIcon elements |
| Item Specifics | Key-value item attributes JSON * | Detail item details list |
| Scraped At | Timestamp when the record was scraped | Auto-generated |
9. Free vs Pro
Free:
- Scrape current page (single listing page).
- Up to 500 items per scrape session.
- Basic fields: title, price, image, condition, sold status.
- Auto-scroll to load more products.
- CSV export with a Free watermark header.
Pro ($1/mo, billed yearly):
- Unlimited items — no record cap.
- Detail page enrichment — 30+ fields per item including full description, seller profile, shipping, item specifics, all images.
- Filters — filter by status (on sale / sold), price range, and condition.
- Scrape Category mode — browse Mercari's full category tree (T1/T2/T3) and scrape entire categories automatically.
- Image download — save product images to disk as the scrape runs.
- Clean CSV export — no Free watermark, all fields included.
10. License & Activation
Pro access is managed through Paddle, our payment and license partner. After purchase, you receive a license key by email.
Activating your Pro license
- Open the Mercari Scraper popup in Chrome.
- The Activate Pro panel appears at the top when you are on the Free tier.
- Paste your license key (format:
MERCARI-PRO-XXXX-XXXX) and click Activate. - The badge changes to Pro and all features are unlocked immediately.
Note: The license is saved locally in Chrome storage. You only need to activate once per browser profile. Clearing extension data will require re-activation.
11. Recommended Workflow
- Test with defaults: Open a Mercari search page and click Start. Let it scrape the visible items and verify the preview looks correct.
- Check Preview: Review captured data in the popup's preview section. Confirm that titles, prices, and images are populating correctly.
- Enable detail scraping (Pro): Turn on Scrape detail pages in settings for full seller profiles, descriptions, and shipping data. Adjust Max concurrent tabs based on your connection speed (2–4 recommended).
- Run category scrape (Pro): Switch to Scrape Category mode, select the categories you want, and let the scraper run through them automatically.
- Export: Once the status shows "Completed", click Export CSV to download all records.
12. CSV Export
Exported CSV includes columns corresponding to all collected fields. Detail-enriched records include 30+ columns. The CSV uses comma delimiters, double-quoted fields, and proper escaping. Open directly in Excel or Google Sheets.
The Free export adds a preamble line: # Exported with Mercari Scraper Free — upgrade to Pro for unlimited exports. The Pro export is clean with no preamble.
13. Troubleshooting
13.1 No products found
- Ensure you are on a valid Mercari US page (
www.mercari.com/us/...). - Scroll down a little manually before pressing Start to make sure products have loaded in the browser.
- Check that you granted host permissions for
www.mercari.com.
13.2 Scraper stops early
- If you hit the Free limit (500 items), the scraper stops automatically. Export your data or upgrade to Pro for unlimited records.
- Increase Scroll delay settings if the page is loading slower than the scraper scrolls.
- Check your internet connection speed.
13.3 Detail pages timing out
- Reduce Max concurrent tabs to 1 or 2.
- Ensure your internet connection is stable.
13.4 Scraper not starting
- Open
chrome://extensions, ensure the extension is enabled, and reload the page. - Check the extension popup isn't being blocked.
13.5 Data not exporting
- Click Clear Data and re-run the scrape.
- Ensure at least one record has been collected.
14. Frequently Asked Questions
Does the scraper work on Mercari Japan (jp.mercari.com)?
The current version is built for the US site at www.mercari.com/us/. Mercari Japan uses a different subdomain and URL structure. A JP-compatible version is in development.
Can I use this while browsing normally?
Yes. The scraper operates in background tabs. Performance impact depends on the Max concurrent tabs setting. Lower it to 1 if you need to browse smoothly.
What happens if my computer goes to sleep?
The scraper pauses when the tab becomes inactive. Click Resume when you return. All collected data is preserved in storage.
Does the scraper handle sold items?
Yes — sold and on-hold items are detected via the SoldBadge and OnHoldBadge data-testid elements, and the isSold field is set accordingly.
Can I scrape multiple categories at once?
Yes, with the Scrape Category mode (Pro). You can select multiple T1/T2/T3 categories and the scraper will visit each one sequentially.
What is the Free limit?
Free tier caps at 500 items per scrape and only scrapes the current page. Detail page enrichment and filters are Pro-only features.
Credits
Built by morkerr.com.
This is the Lite version of the Mercari Scraper (limited to 500 items / current page). Upgrade to Pro for unlimited items, detail page enrichment, filters, and category scraping.
Disclaimer: Web scraping may violate terms of service of some websites. Always review site policies and use responsibly. This tool is designed for legitimate market research and data analysis only.
Documentation v1.1 — July 2026