Mercari Japan Listings Scraper

Scrape public Mercari Japan search results for resale sourcing, marketplace monitoring, and price research.

What does Mercari Japan Listings Scraper do?

Mercari Japan Listings Scraper extracts public listing cards from jp.mercari.com search result pages. Give it keywords such as nintendo switch, or paste Mercari Japan search URLs, and it returns structured rows with title, JPY price, item URL, image URL, listing ID, status, source URL, and scrape timestamp.

Who is it for?

• 🛒 Resellers tracking Japanese second-hand marketplace prices.
• 🎮 Collectibles buyers monitoring games, cards, cameras, fashion, toys, and electronics.
• 📊 Marketplace analysts comparing on-sale and sold-out listing prices.
• 🧰 Automation teams feeding Mercari Japan data into spreadsheets, alerts, BI tools, or repricing workflows.

Why use this scraper?

Mercari Japan is a fast-moving C2C marketplace. Manual checks are slow when you need to watch many keywords. This actor turns public search pages into exportable datasets that can be filtered, scheduled, and integrated through Apify.

What data can you extract?

Field	Description
itemId	Mercari item identifier when available.
title	Public listing title.
price	Parsed source price in Japanese yen.
currency	JPY.
displayPrice	Human-readable yen price.
status	on_sale or sold_out when detectable.
itemUrl	Absolute Mercari Japan item URL.
imageUrl	Main listing thumbnail URL.
imageUrls	Array of image URLs found on the card.
sourceUrl	Search URL that produced the row.
keyword	Keyword parsed from the source URL.
scrapedAt	ISO scrape timestamp.

How much does it cost to scrape Mercari Japan listings?

The actor uses pay-per-event pricing: a small start fee plus a per-listing event. The exact live price is shown on the Apify actor page before you run it. Keep first tests small, for example 20 listings, then scale after confirming the output matches your workflow.

How to use

1. Open the actor on Apify.
2. Enter one or more keywords, such as nintendo switch or sony camera.
3. Or paste public Mercari Japan search URLs in startUrls.
4. Set maxItems to your desired limit.
5. Run the actor.
6. Download results as JSON, CSV, Excel, XML, or RSS from the dataset.

Input options

Keywords

Use keywords for simple searches. Each keyword becomes a Mercari Japan search URL.

Start URLs

Use startUrls when you already have a filtered Mercari Japan search URL, for example a sold-out status filter or category URL.

Maximum listings

Use maxItems to cap the total number of saved rows across all keywords and URLs.

Proxy configuration

Proxy is optional. The default prefill keeps proxy disabled for the cheapest first run. Enable Apify Proxy if your run is blocked from your region.

Example input

{
  "keywords": ["nintendo switch"],
  "maxItems": 20,
  "proxyConfiguration": { "useApifyProxy": false }
}

Example URL input

{
  "startUrls": [
    { "url": "https://jp.mercari.com/search?keyword=pokemon&status=sold_out" }
  ],
  "maxItems": 50
}

Example output

{
  "itemId": "m64388983006",
  "title": "Nintendo Switch 2 本体 日本国内専用　未開封",
  "price": 53800,
  "currency": "JPY",
  "displayPrice": "¥53,800",
  "status": "on_sale",
  "itemUrl": "https://jp.mercari.com/item/m64388983006",
  "imageUrl": "https://static.mercdn.net/thumb/item/webp/m64388983006_1.jpg",
  "imageUrls": ["https://static.mercdn.net/thumb/item/webp/m64388983006_1.jpg"],
  "sourceUrl": "https://jp.mercari.com/search?keyword=nintendo+switch",
  "keyword": "nintendo switch",
  "scrapedAt": "2026-06-06T08:12:48.772Z"
}

Tips for better results

• Start with specific keywords such as model names, product codes, or Japanese terms.
• Use Mercari's own filters in the browser, then paste the filtered URL into startUrls.
• Use sold-out URLs for historical sold price research.
• Keep maxItems low while testing a new keyword set.
• Schedule recurring runs to monitor price changes over time.

Common use cases

• Reseller sourcing lists for electronics, trading cards, toys, and fashion.
• Sold-price monitoring for Japanese marketplace comps.
• Alert workflows for newly listed items under a target price.
• Spreadsheet enrichment with Mercari Japan item URLs and thumbnails.
• Product research for cross-border shopping and import decisions.

Integrations

Use Apify integrations to send Mercari Japan rows to:

• Google Sheets for sourcing dashboards.
• Zapier or Make for alerts and workflow automation.
• Webhooks for real-time notifications.
• Data warehouses for marketplace analytics.
• Custom apps through the Apify API.

API usage with Node.js

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('automation-lab/mercari-japan-listings-scraper').call({
  keywords: ['nintendo switch'],
  maxItems: 20,
});
console.log(run.defaultDatasetId);

API usage with Python

from apify_client import ApifyClient

client = ApifyClient('MY-APIFY-TOKEN')
run = client.actor('automation-lab/mercari-japan-listings-scraper').call(
    run_input={'keywords': ['nintendo switch'], 'maxItems': 20}
)
print(run['defaultDatasetId'])

API usage with cURL

curl -X POST 'https://api.apify.com/v2/acts/automation-lab~mercari-japan-listings-scraper/runs?token=MY-APIFY-TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"keywords":["nintendo switch"],"maxItems":20}'

MCP server usage

Connect this actor to AI tools through the Apify MCP server:

https://mcp.apify.com/?tools=automation-lab/mercari-japan-listings-scraper

Add the Apify MCP server in Claude Code:

$claude mcp add apify https://mcp.apify.com/?tools=automation-lab/mercari-japan-listings-scraper

Claude Desktop MCP configuration example:

{
  "mcpServers": {
    "apify-mercari-japan": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.apify.com/?tools=automation-lab/mercari-japan-listings-scraper"
      ]
    }
  }
}

Example prompts showing MCP usage:

Claude Code prompt

"Use the Apify MCP tool automation-lab/mercari-japan-listings-scraper for sony camera, return the 20 cheapest listings, and summarize title, price, and URL."

Claude Desktop prompt

"Run the Mercari Japan Listings Scraper through MCP for Pokemon cards, compare sold listings with on-sale listings, and create a pricing summary from the dataset."

Scheduling

Create an Apify schedule to run the scraper daily or hourly. Scheduled runs are useful for price monitoring, new listing alerts, and sold-status tracking.

Data quality notes

The actor extracts public search-card data. Some fields such as seller, brand, category, condition, or location may not be present on search cards and are left empty unless publicly visible in the rendered page.

Limitations

• The actor does not log in.
• The actor does not scrape private account-only data.
• Search result availability may vary by region and Mercari UI changes.
• Very broad keywords can return many similar listings; use filters for cleaner results.

Troubleshooting

The run returned no items

Check that the keyword has public Mercari Japan results. Try a smaller maxItems and a direct startUrls search URL copied from your browser.

The page is blocked

Enable Apify Proxy in the input. If the site still blocks your run, try again later with a lower concurrency and smaller item limit.

Legality

This actor is designed to collect publicly visible marketplace search data. You are responsible for using the data legally, respecting Mercari's terms, and avoiding personal or private information.

FAQ

Does this actor require a Mercari account?

No. It only opens public Mercari Japan search and category pages and does not log in.

Can it scrape sold listings?

Yes, if the public search URL includes Mercari's sold-status filter. The actor also detects sold badges when they are visible on search result cards.

Why are some seller, brand, or condition fields empty?

Mercari search cards do not always expose those fields publicly. The actor leaves unavailable fields empty rather than inventing values.

Related scrapers

• https://apify.com/automation-lab/ebay-sold-listings-scraper
• https://apify.com/automation-lab/ebay-scraper
• https://apify.com/automation-lab/amazon-product-scraper

Changelog

0.1

Initial version for public Mercari Japan search result listings.

Support

If you need a field that is publicly visible but missing from the dataset, open an issue on the actor page with a sample Mercari Japan URL and expected output.

Practical workflow tips

Use the actor as part of a repeatable Mercari Japan research workflow rather than a one-off export.

Keyword planning

Start with precise product names, model numbers, character names, or Japanese terms. Broad English keywords can return unrelated goods, while exact Japanese searches usually produce cleaner price comparisons.

Sold listing analysis

For market comps, combine Mercari's sold-status filter with a moderate maxItems value. Export the dataset to CSV, sort by price, and remove incomplete or damaged goods before calculating averages.

Monitoring live inventory

For sourcing or arbitrage workflows, schedule the actor with the same keyword set and compare new itemId values against your previous dataset exports. The scrapedAt and sourceUrl fields make it easier to track when and where an item was observed.

Data quality checks

Before scaling a run, inspect the first rows in the Apify dataset preview. Confirm that prices are numeric JPY values, item URLs open correctly, and image URLs resolve. Increase maxItems only after the query produces relevant results.

Cost control

Keep exploratory runs small, then scale the item limit when the query is validated. Use the proxy option only if direct access is unreliable for your workload.