# Mercari Japan Scraper | ($0.99/1K Results) (`scrapers-hub/mercari-jp-search-scraper`) Actor

\[𝘾𝙝𝙚𝙖𝙥𝙚𝙨𝙩] Mercari JP Search scraper to extract product listings, prices, seller information, item conditions, images, categories, and other publicly available marketplace data from Mercari Japan 🛍️📊 Perfect for e-commerce research, price monitoring, and competitor analysis.

- **URL**: https://apify.com/scrapers-hub/mercari-jp-search-scraper.md
- **Developed by:** [Scrapers Hub](https://apify.com/scrapers-hub) (community)
- **Categories:** E-commerce, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.99 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

### Mercari Scraper 🛍️

**Mercari Scraper** collects product listings from Mercari Japan and turns them into a clean, downloadable dataset — titles, prices, photos, conditions, shipping details, sellers, and more. Whether you are sourcing inventory, tracking prices, hunting for collectibles, or researching a market, this Mercari Scraper does the searching and organising for you.

No coding and no Mercari account needed. Enter a keyword or paste a search link, press Run, and download the results as a spreadsheet or JSON file.

> 🇯🇵 **Please note:** this **Mercari JP scraper** covers `jp.mercari.com`, the Japanese marketplace. It does not cover Mercari US.

***

### 🚀 Why Choose This Mercari Scraper?

| Feature | What It Means for You |
| --- | --- |
| ✅ **Keywords or Links** | Type a search word or paste a Mercari search link — the **Mercari search scraper** handles both |
| ✅ **Full Price Detail** | Every listing arrives with its price as both text and a number, ready for sorting and maths |
| ✅ **Sold or Available** | Collect only items on sale, only **Mercari sold listings**, or both together |
| ✅ **All Photos Included** | Thumbnails and full-size photo links for every item |
| ✅ **Auction Support** | Bid counts, current highest bid, and deadlines are captured for auction listings |
| ✅ **Spreadsheet-Ready** | Clear, well-labelled columns let you **export Mercari data to CSV**, Excel, or JSON instantly |

***

### 🔑 Key Features of the Mercari Scraper

- 🔎 **Search by Keyword** — type what you are looking for and the Mercari Scraper finds every matching listing
- 🔗 **Search by Link** — already have a filtered Mercari search open? Paste the link and all its filters are respected
- 💴 **Price Range Filters** — set a minimum and maximum in yen so you only collect items in your budget
- 📦 **Availability Filter** — choose items currently on sale, items already sold, or everything
- ↕️ **Sort Your Way** — order results by best match, newest, price, or most liked, ascending or descending
- 🖼️ **Photos and Thumbnails** — direct links to every image on the listing, useful for catalogues and comparisons
- 🏷️ **Brand Details** — brand name and sub-brand where Mercari records them, which matters for **Mercari reseller research**
- 🔨 **Auction Data** — for auction listings you get the bid deadline, total bids, highest bid, and starting price
- 🏪 **Shop Listings** — official shop items are identified and their store details captured
- 🚚 **Shipping Information** — who pays for postage and which shipping method applies
- 📐 **Size and Condition** — item condition and size details so you can filter for quality
- 🎁 **Promotions** — any active promotions attached to a listing
- 🎯 **Set Your Own Size** — collect twenty listings for a quick check or thousands for full market research
- 🔁 **Repeatable Runs** — save your settings and **scrape Mercari listings** again whenever you want fresh numbers
- 🇯🇵 **Built for Japan** — the **Mercari Japan scraper** understands yen pricing, Japanese titles, and local shipping rules

***

### 📝 Input

Everything can be set up with the simple form in the Apify Console. If you prefer to enter settings directly, this is what a full configuration looks like:

```json
{
  "startUrls": [
    "https://jp.mercari.com/en/search?keyword=vintage%20watch&price_min=5000"
  ],
  "keyword": "vintage watch",
  "sort": "created_time",
  "order": "desc",
  "status": "on_sale",
  "priceMin": 5000,
  "priceMax": 50000,
  "limit": 200
}
```

#### Input Settings

| Setting | Type | Default | What It Does |
| --- | --- | --- | --- |
| `startUrls` | list | — | Mercari search links you already have. Filters inside the link — keyword, category, brand, price, condition — are all respected. |
| `keyword` | text | — | What to search for. Used when you have not supplied any links. |
| `sort` | text | `score` | How results are ordered: `score` (best match), `created_time` (newest), `price`, or `num_likes` (most liked). |
| `order` | text | `desc` | Sort direction: `desc` for descending or `asc` for ascending. |
| `status` | text | — | Which listings to keep: leave empty for any, `on_sale` for available items, or `sold_out` for **Mercari sold listings**. |
| `priceMin` | number | — | Only keep listings at or above this price, in yen. |
| `priceMax` | number | — | Only keep listings at or below this price, in yen. |
| `limit` | number | — | The most listings to save in one run. |

💡 **Tip:** using a search link is the quickest way to apply advanced filters. Set up the search on Mercari the way you want it, then paste the link straight into the Mercari Scraper.

***

### 📦 Output

The Mercari Scraper writes one row per listing, laid out the same way every time. That keeps your Mercari data extraction easy to filter, sort, and **export Mercari data to CSV** without cleanup. Here is one listing row:

```json
[
  {
    "type": "listing",
    "listing_id": "m94827361052",
    "url": "https://jp.mercari.com/item/m94827361052",
    "title": "SEIKO 5 自動巻き 腕時計 ヴィンテージ",
    "price": "12800",
    "price_numeric": 12800,
    "currency": "JPY",
    "brand_name": "SEIKO",
    "brand": { "id": 214, "name": "SEIKO", "sub_name": "セイコー" },
    "listing_status": "ITEM_STATUS_ON_SALE",
    "listing_type": "ITEM_TYPE_MERCARI",
    "condition_id": 3,
    "seller": { "seller_id": "884213907" },
    "shipping": { "payer_id": 2, "method_id": 17 },
    "catalog": {
      "category_id": 1108,
      "size_ids": [],
      "item_size": null
    },
    "store": { "name": "", "details": null },
    "media": {
      "thumbnail_urls": ["https://static.mercdn.net/thumb/photos/m94827361052_1.jpg"],
      "photo_urls": ["https://static.mercdn.net/item/detail/orig/photos/m94827361052_1.jpg"]
    },
    "promotions": [],
    "auction": null,
    "attributes": [],
    "pricing": { "amount": 12800, "currency": "JPY", "is_no_price": false },
    "availability": {
      "status": "ITEM_STATUS_ON_SALE",
      "item_type": "ITEM_TYPE_MERCARI",
      "is_shop_item": false
    },
    "timestamps": { "created_unix": 1772438400, "updated_unix": 1772524800 },
    "engagement": { "is_liked": false, "is_no_price": false },
    "scrape_context": {
      "seed": { "type": "url", "value": "https://jp.mercari.com/en/search?keyword=vintage%20watch" },
      "search": { "num_found": 4182 },
      "scraped_time": 1772611200
    }
  }
]
```

#### Listing Columns

| Column | Type | What It Contains |
| --- | --- | --- |
| `type` | text | Always `listing` |
| `listing_id` | text | Mercari's own ID for the item |
| `url` | text | A clickable link to the listing |
| `title` | text | The item name as written by the seller, in Japanese |
| `price` | text | The price exactly as Mercari shows it |
| `price_numeric` | number | The same price as a plain number, ready for sorting and totals |
| `currency` | text | Always `JPY` — Japanese yen |
| `brand_name` | text | The brand, when the seller recorded one |
| `brand` | object | Full brand details including the Japanese sub-name |
| `listing_status` | text | Whether the item is on sale or already sold |
| `listing_type` | text | A standard listing, a shop listing, or an auction |
| `condition_id` | number | Mercari's condition rating, from new to heavily used |
| `seller.seller_id` | text | The seller's identifier, so you can group items by seller |
| `shipping.payer_id` | number | Whether the buyer or seller pays for postage |
| `shipping.method_id` | number | The shipping method Mercari has assigned |
| `catalog.category_id` | number | The category the item is listed under |
| `catalog.item_size` | text | The size, for clothing and footwear |
| `store.name` | text | The shop name, for official shop listings |
| `media.thumbnail_urls` | list | Small preview images |
| `media.photo_urls` | list | Full-size photos of the item |
| `promotions` | list | Any active discounts or campaigns on the listing |
| `auction.bid_deadline` | text | When bidding closes, for auction items |
| `auction.total_bid_count` | number | How many bids have been placed |
| `auction.highest_bid` | number | The current leading bid |
| `auction.initial_price` | number | The starting price of the auction |
| `attributes` | list | Extra item details the seller supplied |
| `pricing.is_no_price` | yes/no | `true` for listings published without a fixed price |
| `availability.is_shop_item` | yes/no | Whether it comes from an official shop rather than an individual |
| `timestamps.created_unix` | number | When the listing was published |
| `timestamps.updated_unix` | number | When it was last updated |
| `scrape_context.search.num_found` | number | How many results Mercari reported for the whole search |
| `scrape_context.scraped_time` | number | When this row was collected |

***

### 🚀 How to Use the Mercari Scraper (Step by Step)

1. **Sign in** — go to [console.apify.com](https://console.apify.com) and open the **Actors** tab.
2. **Open the actor** — search for **Mercari Scraper** and click its card.
3. **Add your search** — type a keyword, or paste a Mercari search link if you have already set up filters on the site.
4. **Set your price range** — enter a minimum and maximum in yen if your budget matters.
5. **Choose availability** — on sale, sold out, or everything.
6. **Pick your order** — best match, newest, price, or most liked.
7. **Set your size** — choose how many listings to collect. Start small to check the output, then increase it.
8. **Press Run and download** — open the **OUTPUT** tab and save as CSV, Excel, JSON, XML, or RSS.

No coding required — the Mercari Scraper gives you a complete dataset in minutes.

***

### 🎯 What Makes This Mercari Scraper Different

- 🔢 **Prices You Can Actually Use** — every price arrives as a real number, so sorting, averaging, and charting work straight away
- 🔗 **Your Filters Are Respected** — paste a search link and every filter inside it carries through, which most tools quietly drop
- 🔨 **Auctions Are Not Ignored** — bid counts, deadlines, and current highest bids are captured, so your **Mercari data extraction** covers auction items properly
- 🏪 **Shops and Individuals Separated** — you can tell official shop inventory apart from private sellers at a glance
- 🖼️ **Full-Size Photos** — not just thumbnails, so listings can be reviewed or catalogued properly
- 📊 **Total Result Counts** — each row records how many items the whole search found, which is useful for sizing a market
- 🕒 **Timestamps Included** — publication and update times let you track how long items sit unsold
- 🔎 **Two Ways In** — the **Mercari search scraper** accepts either a plain keyword or a fully filtered search link, so it fits how you already work
- 🏷️ **Brand-Aware Results** — brand and sub-brand fields make the **Mercari product scraper** output genuinely usable for **Mercari reseller research**

***

### 💡 Best Use Cases for the Mercari Scraper

- 📦 **Reselling and Sourcing** — **scrape Mercari listings** to find underpriced stock before anyone else does
- 💰 **Price Research** — build a **Mercari price tracking** history for a product line and see how values move
- 📈 **Market Sizing** — measure how many sellers compete in a category and at what price points
- ⏱️ **Repricing Decisions** — run the Mercari Scraper on a schedule so your **Mercari price tracking** stays current rather than a one-off snapshot
- 🕵️ **Competitor Analysis** — follow specific sellers and study what they list, at what price, and how fast it sells
- 🎌 **Japan Sourcing for Export** — the **Mercari Japan scraper** helps proxy buyers and export businesses build catalogues
- 🎨 **Collectibles Hunting** — track rare items across a whole category rather than refreshing pages manually
- 📊 **Sold-Price Analysis** — collect **Mercari sold listings** to learn what buyers genuinely paid, not just asking prices
- 👗 **Fashion and Brand Research** — use the **Mercari product scraper** mode to study how specific brands hold their value secondhand
- 📥 **Dashboards and Inventory** — **export Mercari data to CSV** and load it straight into your spreadsheet or stock system

***

### 🔧 Good to Know

A few practical notes before you run the Mercari Scraper:

- **What you can start from**
  - A plain search keyword
  - A Mercari search link with your filters already applied
- **Marketplace covered**
  - `jp.mercari.com` — the Japanese marketplace
- **Currency**
  - All prices are in Japanese yen (JPY)
- **Download formats**
  - CSV, Excel, JSON, XML, and RSS
- **Please note**
  - ❌ Mercari US is not covered by this **Mercari JP scraper**
  - ❌ Private messages, buyer details, and seller contact information are never collected
  - ℹ️ Titles and descriptions come back in Japanese, exactly as sellers wrote them — run them through a translator if you need English
  - ℹ️ Very broad searches return large result counts, so narrow with price and category filters for faster, more useful runs

***

### 🤝 Support & Feature Requests

Need a hand, or have an idea for the **Mercari Scraper**?

- 💡 **Feature Requests** — want automatic translation, seller profile collection, or scheduled price checks? Just ask.
- 📧 **Contact** — email us at <scrapershub@gmail.com>.

Your feedback shapes what we build next and helps keep this the most useful Mercari Scraper on the Apify Store.

***

*Start today with the most complete Mercari Scraper available — prices, photos, sellers, and auctions in one run.*

### Related Scrapers

If the Mercari Scraper is useful to you, these tools from Scrapers Hub collect listings, profiles, posts, and contact details from other platforms:

- [Alibaba Scraper](https://apify.com/scrapers-hub/alibaba-pro-search-scraper)
- [Craigslist Scraper](https://apify.com/scrapers-hub/craigslist-scraper)
- [Avito Scraper](https://apify.com/scrapers-hub/avito-kvartiry-scraper)
- [Pinterest Scraper](https://apify.com/scrapers-hub/pinterest-scraper-all-in-one)
- [Reddit Scraper](https://apify.com/scrapers-hub/reddit-scraper-enterprise)
- [Bluesky Scraper](https://apify.com/scrapers-hub/bluesky-scraper-enterprise-grade)
- [Substack Scraper](https://apify.com/scrapers-hub/substack-scraper)
- [Product Hunt Scraper with Founders & Emails](https://apify.com/scrapers-hub/product-hunt-scraper-with-founders-emails)
- [Y Combinator Scraper with Founders & Emails](https://apify.com/scrapers-hub/y-combinator-scraper-with-founders-emails)

### Disclaimer

This Mercari Scraper collects information only from **publicly available listing pages**. It does not access private accounts, messages, or any password-protected content. You are responsible for following applicable laws and for respecting Mercari's terms of service when using what you collect.

For data removal requests, please contact **<scrapershub@gmail.com>**. Always use these tools responsibly, ethically, and for legitimate purposes only.

# Actor input Schema

## `startUrls` (type: `array`):

Mercari JP search URLs, e.g. https://jp.mercari.com/en/search?keyword=watch . Filters in the URL query (keyword, category\_id, brand\_id, price\_min, price\_max, item\_condition\_id, status, sort, order) are applied.

## `keyword` (type: `string`):

Keyword to search for. Used when no Start URLs are given.

## `sort` (type: `string`):

Ordering of the search results.

## `order` (type: `string`):

Direction to apply to the selected sort.

## `status` (type: `string`):

Only include listings with this status.

## `priceMin` (type: `integer`):

Only include listings priced at or above this amount (JPY).

## `priceMax` (type: `integer`):

Only include listings priced at or below this amount (JPY).

## `limit` (type: `integer`):

Set the maximum number of listings to save

## Actor input object example

```json
{
  "startUrls": [
    "https://jp.mercari.com/en/search?keyword=watch"
  ],
  "sort": "score",
  "order": "desc",
  "status": "",
  "limit": 100
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrls": [
        "https://jp.mercari.com/en/search?keyword=watch"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapers-hub/mercari-jp-search-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "startUrls": ["https://jp.mercari.com/en/search?keyword=watch"] }

# Run the Actor and wait for it to finish
run = client.actor("scrapers-hub/mercari-jp-search-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "startUrls": [
    "https://jp.mercari.com/en/search?keyword=watch"
  ]
}' |
apify call scrapers-hub/mercari-jp-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=scrapers-hub/mercari-jp-search-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/AcASMRruFKSxQhiJ1/builds/pkoUQ9NEReQwONnQm/openapi.json