# Mercari Japan Scraper: Listings, Sold Prices and Sellers (`themineworks/mercari-scraper`) Actor

Scrape Mercari Japan listings by keyword, category, brand, seller or link: price in yen, on sale or sold, condition, brand, shipping, seller name and rating, likes, description, photos and link. Sold price comps. No login.

- **URL**: https://apify.com/themineworks/mercari-scraper.md
- **Developed by:** [The Mine Works](https://apify.com/themineworks) (community)
- **Categories:** E-commerce, Automation, Developer tools
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.79 / 1,000 listings

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Mercari Japan Scraper: Listings, Sold Prices and Sellers

[![30 Mercari Japan listings with price, status, seller rating and likes in 4 seconds](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/mercari-scraper-hero.png)](https://console.apify.com/actors/Zqhc78vfHF6St6aLI/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

Returns Mercari Japan (jp.mercari.com) listings by keyword, category, brand, seller or shop, or from pasted Mercari search and item links: one row per listing with title, price in yen, status (on sale, in trade or sold out), condition, brand, category, shipping, seller name and star rating, likes, comments, description, photos and link. No login, no cookies, no API key. You pay $3.59 per 1,000 listings on the Free plan and $1.79 per 1,000 on the Gold plan, plus a $0.001 start fee per run.

**Part of The Mine Works E-commerce and marketplaces family:** [Ozon.ru Scraper](https://apify.com/themineworks/ozon-product-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [⭐ Amazon Reviews Scraper](https://apify.com/themineworks/amazon-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Amazon Product Scraper](https://apify.com/themineworks/amazon-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Etsy Listings Scraper](https://apify.com/themineworks/etsy-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [AliExpress Scraper](https://apify.com/themineworks/aliexpress-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Kleinanzeigen.de Scraper](https://apify.com/themineworks/kleinanzeigen-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral).

Updated 19 Nov 2026: first release. Keyword, category and brand search, on sale or sold listings for price comps, price, condition, shipping and seller type filters, pasted search, category, brand, seller, shop and item links, Mercari Shops products, and each listing's own record (seller name and rating, likes, comments, description, shipping details, every photo), one flat row per listing. Bookmark this Actor on its Store page so it is one click away next time.

### Why choose this actor?

- **Seller rating and likes in every row, at the search price.** Each listing's own record is read by default, so `seller_name`, `seller_rating`, `seller_ratings_count`, `likes_count`, `description` and the shipping details sit next to the price. Other Mercari actors return only a seller id in search rows, or charge extra for details. In our test runs on Apify, `seller_rating` was filled on 983 of 983 rows.
- **Sold prices for comps.** Set `status` to `sold` and every row is a listing that sold or is in trade, with its price, condition and the date it was last updated. Sort by `newest` to see what sold this week.
- **Paste what you see.** A search link from your browser keeps every filter in it (category, brand, size, colour, condition, price, status, sort). Seller profile and shop links return that seller's listings; item links return that one listing.
- **Pay per listing, nothing for errors.** Links that are not Mercari Japan links, listings that no longer exist, the summary row and listings found twice in one run are never charged.

[![Run it on Apify](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/button-run.png)](https://console.apify.com/actors/Zqhc78vfHF6St6aLI/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

### Try it in one minute

Paste this into the input (JSON view) and press Start. It returns 30 "nintendo switch" listings that are on sale, with seller name, rating, likes and description. It took 4 seconds in our test run on Apify:

```json
{
  "searchQueries": ["nintendo switch"],
  "maxItems": 30
}
```

Put several keywords on separate lines to run several searches at once, in Japanese or English. A listing that two of your searches find is delivered once.

Apify's free plan includes $5 of credit every month, which covers about 1,390 listings at this actor's Free plan price.

#### Copy to your AI assistant

```text
themineworks/mercari-scraper on Apify. Searches Mercari Japan (jp.mercari.com, second hand marketplace) by keyword, category, brand, seller or shop, or reads pasted jp.mercari.com links, and returns one flat row per listing, no login. Call ApifyClient("TOKEN").actor("themineworks/mercari-scraper").call(run_input={"searchQueries": ["nintendo switch"], "status": "sold", "maxItems": 100}), then client.dataset(run["defaultDatasetId"]).list_items().items. Give searchQueries (list of keywords), startUrls (jp.mercari.com search, category, brand, /item/, /shops/product/, /user/profile/ or /shops/profile/ links, or bare item ids like m12345678901), categoryIds or brandIds; up to 100 searches. Optional: status (on_sale, sold, all; default on_sale), sortBy (relevance, newest, price_low, price_high, most_liked), minPrice, maxPrice (JPY), condition (list of new, like_new, good, fair, poor, bad), shippingPaidBy (any, seller, buyer), sellerType (any, individual, shops), excludeKeywords, maxItems (default 100, 1 to 10000, per search), includeDetails (default true). Listing rows have no _type field and carry item_id, url, title, price, currency, status, is_sold, condition, condition_label, condition_label_ja, condition_id, brand, brand_id, category_id, category, category_path, seller_type, seller_id, seller_url, seller_name, seller_rating, seller_ratings_count, seller_ratings_good, seller_ratings_normal, seller_ratings_bad, seller_listings_count, seller_is_official, seller_quick_shipper, seller_since, shop_id, shop_name, shipping_paid_by, shipping_included, shipping_label_ja, shipping_method_id, shipping_method, shipping_from, shipping_days_min, shipping_days_max, likes_count, comments_count, description, hashtags, size, sizes, image_url, image_urls, images_count, thumbnail_url, discount_percent, is_offerable, is_auction, auction_bids, auction_highest_bid, auction_start_price, auction_ends_at, stock_quantity, variants_count, created_at, updated_at, details_scraped, details_error, source, search_input, search_url, page, position, scraped_at. Each run also writes one row with _type "summary", one with _type "info" when listings were delivered, and a row with _type "error" for each input that could not be read; none of these is charged. Full spec: GET https://api.apify.com/v2/acts/themineworks~mercari-scraper/builds/default (Bearer TOKEN), which returns inputSchema and readme. Token: https://console.apify.com/account/integrations?fpr=ymnoit&utm_source=apify-readme&utm_medium=referral
```

### Key features

- **Mercari's own filters.** Status (on sale, sold, all), price range in yen, six conditions, shipping included or paid by the buyer, individual sellers or Mercari Shops only, exclude words, category and brand ids, and five sort orders, the same as on the site.
- **Whole categories and brands.** Give `categoryIds` or `brandIds` with no keyword and the actor lists that category or brand.
- **Sellers and shops.** A seller profile link (`/user/profile/<id>`) returns that seller's listings, on sale and sold; a Mercari Shops link (`/shops/profile/<id>`) returns that shop's products.
- **Listing details.** With `includeDetails` on (the default) each row adds the seller name, star rating, good, normal and bad ratings, listings count and member since, likes, comments, the full description, Japanese category path, shipping method, ship from prefecture, days to ship and every full size photo. Mercari Shops rows carry the shop name, shop score and review count, stock and variants.
- **Auctions.** Listings sold as auctions carry the bid count, highest bid, starting price and end time.
- **Stops cleanly.** An empty search ends after one request. Two pages in a row with no new listing end a search; five failed requests in a row end the run; the run stops before its time limit and keeps every row. The summary row says why.

### How to use it

#### Sold price comps

```json
{
  "searchQueries": ["ポケモンカード", "iphone 15"],
  "status": "sold",
  "sortBy": "newest",
  "maxItems": 300
}
```

The most recent sales first. In our test run on Apify this returned 600 sold or in trade listings in 54 seconds, with details.

#### One category, new and like new, shipping included

```json
{
  "categoryIds": ["702"],
  "condition": ["new", "like_new"],
  "shippingPaidBy": "seller",
  "sellerType": "individual",
  "maxPrice": 5000,
  "maxItems": 200
}
```

Every row is a Nintendo Switch game (category 702) under 5,000 yen from an individual seller. In our test run on Apify: 200 rows in 14 seconds.

#### Your own search link, a seller and a shop

```json
{
  "startUrls": [
    "https://jp.mercari.com/search?keyword=iphone%2015&status=on_sale&item_condition_id=1%2C2&sort=price&order=asc&price_min=50000",
    "https://jp.mercari.com/user/profile/425345800",
    "https://jp.mercari.com/item/m81294174108"
  ],
  "maxItems": 60
}
```

Set the filters on jp.mercari.com, copy the address bar and schedule the run. Compare runs on `item_id`, `price` and `status` to catch new listings, price cuts and sales.

#### Fast mode

```json
{
  "searchQueries": ["ルイヴィトン 財布"],
  "status": "all",
  "includeDetails": false,
  "maxItems": 2000
}
```

Rows come from the search pages only (up to 120 listings per request): title, price, status, condition, brand, category id, seller id, shipping payer and photos, without seller name, rating, likes and description. Same price per row. In our test run on Apify: 2,000 listings in 25 seconds.

### Input parameters

| Field | Type | Default | What it does |
|---|---|---|---|
| `searchQueries` | list of text | | Keywords, one search each, Japanese or English. Up to 100 searches per run. |
| `startUrls` | list of text | | jp.mercari.com search, category, brand, item, Mercari Shops product, seller or shop links, or bare item ids. |
| `status` | choice | on_sale | on_sale, sold (sold out and in trade) or all. |
| `sortBy` | choice | relevance | relevance, newest, price_low, price_high, most_liked. |
| `minPrice` / `maxPrice` | number | | Price range in yen. |
| `condition` | list | any | new, like_new, good, fair, poor, bad. |
| `shippingPaidBy` | choice | any | any, seller (shipping included) or buyer. |
| `sellerType` | choice | any | any, individual or shops (Mercari Shops). |
| `categoryIds` / `brandIds` | list of text | | Mercari category or brand ids; alone they list the whole category or brand. |
| `excludeKeywords` | text | | Leave out listings with these words. |
| `maxItems` | number | 100 | Most listings per keyword, category or link, 1 to 10,000. |
| `includeDetails` | true/false | true | Reads each listing's record for seller name and rating, likes, comments, description, shipping details and photos. |

### What data do you get?

One row per listing. Listing rows have no `_type` field; the summary, info and error rows do, so a filter on `_type` separates them.

| Field | Example | Notes |
|---|---|---|
| `item_id` / `url` | m62059796245 | link to the listing on jp.mercari.com |
| `title` / `description` | Apple iPhone15 pink 本体 | as the seller wrote them, mostly Japanese |
| `price` / `currency` | 30000 / JPY | |
| `status` / `is_sold` | sold_out / true | on_sale, trading or sold_out |
| `condition` / `condition_label` / `condition_label_ja` / `condition_id` | bad / Poor condition overall / 全体的に状態が悪い / 6 | |
| `brand` / `brand_id` | Apple / 3272 | when the seller set one |
| `category_id` / `category` / `category_path` | 859 / スマートフォン本体 | path with details |
| `seller_type` / `seller_id` / `seller_url` | individual / 708975975 | individual or mercari_shops |
| `seller_name` / `seller_rating` / `seller_ratings_count` | user_7cdae2ba / 5 / 1 | with details |
| `seller_ratings_good` / `_normal` / `_bad` / `seller_listings_count` / `seller_since` | 1 / 0 / 0 / 2 | with details |
| `shop_id` / `shop_name` / `stock_quantity` / `variants_count` | | Mercari Shops rows |
| `shipping_paid_by` / `shipping_included` | seller / true | |
| `shipping_method` / `shipping_from` / `shipping_days_min` / `shipping_days_max` | らくらくメルカリ便 / 東京都 / 1 / 2 | with details |
| `likes_count` / `comments_count` | 8 / 3 | with details |
| `image_url` / `image_urls` / `images_count` / `thumbnail_url` | static.mercdn.net links | full size photos with details |
| `is_auction` / `auction_bids` / `auction_highest_bid` / `auction_ends_at` | true / 3 / 1700 | auctions only |
| `created_at` / `updated_at` | 2026-11-18T05:10:49Z | |
| `source` / `search_input` / `search_url` / `page` / `position` | search / iphone 15 / 2 / 198 | where the row came from |

Optional, present only when Mercari has a value: `brand` (405 of 983 test rows) exists when the seller picked one; auction fields only on auctions; shop fields only on Mercari Shops rows. Titles, descriptions, categories and shipping names are in Japanese, as on the site; condition and status also come as English codes.

#### Output example

```json
{
  "item_id": "m62059796245",
  "url": "https://jp.mercari.com/item/m62059796245",
  "title": "Apple iPhone15 pink 本体",
  "price": 30000,
  "currency": "JPY",
  "status": "sold_out",
  "is_sold": true,
  "condition": "bad",
  "condition_label": "Poor condition overall",
  "brand": "Apple",
  "category_id": 859,
  "category_path": "スマホ・タブレット・パソコン > スマートフォン・携帯電話 > スマートフォン本体",
  "seller_type": "individual",
  "seller_id": "708975975",
  "seller_url": "https://jp.mercari.com/user/profile/708975975",
  "seller_name": "user_7cdae2ba",
  "seller_rating": 5,
  "seller_ratings_count": 1,
  "shipping_paid_by": "seller",
  "shipping_method": "らくらくメルカリ便",
  "shipping_days_min": 1,
  "shipping_days_max": 2,
  "likes_count": 0,
  "comments_count": 0,
  "image_url": "https://static.mercdn.net/item/detail/orig/photos/m62059796245_1.jpg?1794978649",
  "images_count": 6,
  "created_at": "2026-11-18T05:10:49.000Z",
  "updated_at": "2026-11-19T12:48:08.000Z",
  "search_input": "iphone 15",
  "page": 2,
  "position": 198
}
```

### Pricing

Pay per event: you pay for the listings you receive, plus a flat $0.001 per run, whatever memory you choose. Listing details cost nothing extra.

| Event | When it is charged | Free plan | Bronze (Starter) | Silver (Scale) | Gold (Business) |
|---|---|---|---|---|---|
| `listing-scraped` | Once per listing row stored in your dataset | $3.59 per 1,000 | $2.69 per 1,000 | $1.79 per 1,000 | $1.79 per 1,000 |
| `run-start` | Once per run, after the first page returned listings | $0.001 | $0.001 | $0.001 | $0.001 |

Never charged:

- links that are not Mercari Japan links, and listings that no longer exist (each gets an error row);
- a listing that a second search of the same run finds again;
- listings past your `maxItems`;
- the summary, info and error rows;
- a run with no valid input, or one whose searches return no listings: the start fee is charged only once listings came back;
- anything past your "Max cost per run". The actor checks the budget before each batch of rows and stops while the total is still below your limit.

### How it compares

| Actor | Users | Price per 1,000 on the Free plan | Price per 1,000 on Gold | Seller name and rating | Sold listings |
|---|---|---|---|---|---|
| **This actor** | new | $3.59 | $1.79 | Yes, in every row at the same price | Yes |
| [Mercari Japan Scraper by fatihtahta](https://apify.com/fatihtahta/mercari-japan-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | 288 | $3.99 | $1.99 | Seller id only | Yes |
| [Mercari Japan Scraper by piotrv1001](https://apify.com/piotrv1001/mercari-listings-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | 144 | $4.00, item details $8.00 | $4.00, item details $8.00 | With item details or seller profiles, charged extra | Yes |
| [Mercari Japan Scraper by logiover](https://apify.com/logiover/mercari-japan-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | 71 | $3.50 | $1.99 | Optional | Yes |

Checked 19 Nov 2026 from the public Store listings.

### Run it on a schedule

1. Open the actor in Apify Console, set your input and click **Save as a new task**.
2. In the task, open **Schedules**, click **Add schedule** and pick how often (every hour, every morning at 08:00 and so on).
3. Use `"sortBy": "newest"` to get fresh listings first, and compare runs on `item_id`, `price` and `status` to see new listings, price cuts and sales.
4. Optional: add an integration (Google Sheets, Slack, a webhook) so each run lands where your team works.

### FAQ

#### What does this actor read?

Mercari Japan's public search results and each listing's public record, as anyone sees them on jp.mercari.com without logging in. It does not log in, like, comment, buy or make offers.

#### Do I need an account, cookies or an API key?

No account, no cookies and no API key. Nothing to set up. The Mercari web app signs each of its requests with a short lived key that the browser makes for itself; the actor makes its own key the same way, with no account behind it.

#### How many listings can I get?

Up to 10,000 per search and 100 searches per run. A results page holds up to 120 listings. Mercari shows "15,000" as the count for big searches; that is a ceiling, not a count. Narrow a big search with a category, price range or condition to reach more listings in total.

#### Does it work for Mercari US (mercari.com)?

No. This actor reads Mercari Japan (jp.mercari.com) only. A www.mercari.com link gets an error row and is not charged.

#### Why are titles in Japanese?

Mercari Japan sellers write their listings in Japanese, and the actor returns them as written. Status and condition also come as English codes (`on_sale`, `sold_out`, `like_new`), and prices are plain numbers in yen, so you can filter and sort without reading Japanese.

#### How long does a run take?

In our test runs on Apify: 4 seconds for the "Try it" input (30 listings with details), 14 seconds for 200 listings and 54 seconds for 600 listings, all with details on. With `includeDetails` off, each page of up to 120 listings is a single request: 2,000 listings took 25 seconds.

#### Which formats can I download?

JSON, CSV, Excel, XML, RSS and HTML from the run's Storage tab or through the API.

#### Can I use it from Claude, ChatGPT or Cursor (MCP)?

Yes, through Apify's MCP server. Connector URL: https://mcp.apify.com/?tools=themineworks/mercari-scraper

- Claude: Settings > Connectors > Add custom connector, paste the URL, sign in with Apify.
- ChatGPT: turn on developer mode, add an MCP connector with the URL, sign in with Apify.
- Cursor or VS Code: add it as an HTTP MCP server with that URL.
- Claude Code: `claude mcp add -t http mercari-scraper "https://mcp.apify.com/?tools=themineworks/mercari-scraper"`

#### Is it legal to scrape Mercari?

The actor reads only public listings that anyone can see without logging in. Seller names are the display names sellers choose for their public profile, and no contact details are collected. You are responsible for how you use the data, including Mercari's terms and data protection law such as Japan's APPI.

### Integrations

- **Google Sheets**: send each run's listings to a sheet with Apify's Google Sheets integration; one row per listing fits a sheet as is.
- **Make, Zapier and n8n**: start a run and read its dataset with the Apify apps and nodes, for example "new Pokemon card listings under 3,000 yen every hour to Slack".
- **Webhooks**: have Apify call your URL when a run succeeds, then fetch the dataset.
- **API and SDKs**: run it from Python or JavaScript with the Apify client, or with a plain HTTP call (see "Copy to your AI assistant" above).
- **MCP clients**: Claude, ChatGPT, Cursor and VS Code can run it as a tool through the connector URL in the FAQ.

If this actor saved you time, a short rating on the Store helps other buyers find it.

### More from The Mine Works

**E-commerce and marketplaces**

- [Ozon.ru Scraper](https://apify.com/themineworks/ozon-product-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [⭐ Amazon Reviews Scraper](https://apify.com/themineworks/amazon-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Amazon Product Scraper](https://apify.com/themineworks/amazon-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Etsy Listings Scraper](https://apify.com/themineworks/etsy-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [AliExpress Scraper](https://apify.com/themineworks/aliexpress-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Kleinanzeigen.de Scraper](https://apify.com/themineworks/kleinanzeigen-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Carsales.com.au Scraper](https://apify.com/themineworks/carsales-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [eBay Product Listings Scraper](https://apify.com/themineworks/ebay-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Shopify Store Scraper](https://apify.com/themineworks/shopify-store-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [🛒 TikTok Shop Scraper](https://apify.com/themineworks/tiktok-shop-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Walmart Product & Price Scraper](https://apify.com/themineworks/walmart-product-price-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Vinted Scraper](https://apify.com/themineworks/vinted-listings-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Social media and video**

- [Threads Scraper](https://apify.com/themineworks/threads-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Reddit Scraper](https://apify.com/themineworks/reddit-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Threads Search Scraper](https://apify.com/themineworks/threads-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Instagram Profile Scraper](https://apify.com/themineworks/instagram-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Leads and business directories**

- [B2B Leads Finder](https://apify.com/themineworks/b2b-leads-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Skip Trace Lookup](https://apify.com/themineworks/skip-trace-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Maps Email Scraper](https://apify.com/themineworks/maps-leads?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [2GIS Places Scraper](https://apify.com/themineworks/2gis-places-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Marketing, SEO and reviews**

- [Facebook Ad Library Scraper](https://apify.com/themineworks/meta-ad-library-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Ads Transparency Scraper](https://apify.com/themineworks/google-ads-transparency?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Similarweb Scraper](https://apify.com/themineworks/similarweb-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google News Scraper](https://apify.com/themineworks/google-news?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**LinkedIn**

- [LinkedIn Company Scraper](https://apify.com/themineworks/linkedin-company-details?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Post Scraper](https://apify.com/themineworks/linkedin-post-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Employees Scraper](https://apify.com/themineworks/linkedin-employees?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Profile Scraper](https://apify.com/themineworks/linkedin-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Real estate**

- [Zillow Rentals Scraper](https://apify.com/themineworks/zillow-rental-listings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zillow Sold Comps Scraper](https://apify.com/themineworks/zillow-recently-sold?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Real Estate MCP](https://apify.com/themineworks/india-real-estate-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Housing.com Scraper](https://apify.com/themineworks/housing-com-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Science, health and government data**

- [Academic Research MCP](https://apify.com/themineworks/academic-research-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [CourtListener Scraper](https://apify.com/themineworks/courtlistener-court-records?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Socrata Open Data Scraper](https://apify.com/themineworks/socrata-open-data?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [OpenAlex Scraper](https://apify.com/themineworks/openalex-scholarly-works?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Jobs and hiring**

- [Foundit Monster India Jobs](https://apify.com/themineworks/foundit-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Hirist Jobs Scraper](https://apify.com/themineworks/hirist-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Jobs MCP](https://apify.com/themineworks/india-jobs-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naukri Jobs Scraper](https://apify.com/themineworks/naukri-jobs?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Company and business data**

- [Company Domain Finder](https://apify.com/themineworks/company-domain-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GST Taxpayer Lookup](https://apify.com/themineworks/gst-taxpayer-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Company KYB Resolver](https://apify.com/themineworks/company-identity-resolver?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [SEC EDGAR Filings Scraper](https://apify.com/themineworks/sec-edgar-filings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Food and local services**

- [NoBroker Scraper](https://apify.com/themineworks/nobroker-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Swiggy Restaurant Scraper](https://apify.com/themineworks/swiggy-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zomato Scraper](https://apify.com/themineworks/zomato-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Developer and AI tools**

- [Website to Markdown Crawler](https://apify.com/themineworks/rag-crawler?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Skill Finder](https://apify.com/themineworks/github-skill-discovery?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Repo Scraper](https://apify.com/themineworks/github-repo-intelligence?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Trending Scraper](https://apify.com/themineworks/github-trending-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**More tools**

- [G2 Reviews Scraper](https://apify.com/themineworks/g2-reviews-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naver Blog Scraper](https://apify.com/themineworks/naver-blog-posts-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [WeChat Article Scraper 微信公众号文章](https://apify.com/themineworks/wechat-article-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Taobao Products Scraper 淘宝 天猫](https://apify.com/themineworks/taobao-products-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

### Support

Found a search that comes back empty, or a field that looks wrong? Open an issue in the Issues tab with the input and the run ID, and we will look at it. For a field you need or another marketplace, email dmineworks@gmail.com.

*Search Mercari Japan by keyword, category, seller or link and get every listing back as one row, with price in yen, status, condition, seller name and rating, likes and photos, no login.*

# Actor input Schema

## `searchQueries` (type: `array`):

What to search for, one per line, in Japanese or English, as you would type it in the Mercari search box. Example: nintendo switch, ポケモンカード, ルイヴィトン 財布. Each keyword is one search. Up to 100 searches per run.

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

Links copied from jp.mercari.com: search results (https://jp.mercari.com/search?keyword=iphone\&status=sold_out%7Ctrading), which keep every filter in the link; category or brand pages; item pages (https://jp.mercari.com/item/m12345678901); Mercari Shops products (https://jp.mercari.com/shops/product/<id>); a seller profile (https://jp.mercari.com/user/profile/<id>) for that seller's listings; or a shop (https://jp.mercari.com/shops/profile/<id>). Bare item ids such as m12345678901 work too.

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

On sale only, sold only (sold out and in trade, for sold price comps) or everything. Applies to keyword and category searches; a pasted link keeps its own status.

## `sortBy` (type: `string`):

Order of the results, as on Mercari. Newest first follows Mercari's own order (last update, so relisted and price cut items come first).

## `minPrice` (type: `integer`):

Only listings priced at or above this, in yen.

## `maxPrice` (type: `integer`):

Only listings priced at or below this, in yen.

## `condition` (type: `array`):

Only listings in these conditions. Empty means any condition.

## `shippingPaidBy` (type: `string`):

Only listings where shipping is included (the seller pays) or where the buyer pays it.

## `sellerType` (type: `string`):

Only listings from individual sellers, or only from Mercari Shops (business sellers).

## `categoryIds` (type: `array`):

Mercari category ids, from the category_id column of a previous run or the category_id in a Mercari search link. Examples: 702 Nintendo Switch games, 7002 Nintendo Switch, 1 Ladies fashion. With no keyword, the whole category is listed.

## `brandIds` (type: `array`):

Mercari brand ids, from the brand_id column of a previous run or the brand_id in a Mercari search link. Example: 7572 Nintendo Switch. With no keyword and no category, the whole brand is listed.

## `excludeKeywords` (type: `string`):

Leave out listings with any of these words, separated by spaces, like Mercari's own exclude filter. Example: ジャンク 箱のみ (junk, box only).

## `maxItems` (type: `integer`):

The most listings to return for each keyword, category or link, 1 to 10,000. A results page holds up to 120 listings; Mercari serves about 10,000 per search at most.

## `includeDetails` (type: `boolean`):

On: each listing's own record is read too, for the seller name, star rating and number of ratings, likes, comments, description, category names, shipping method, ship from prefecture, days to ship and every photo. Off: rows come from the search results only, which is faster. Same price either way.

## Actor input object example

```json
{
  "searchQueries": [
    "nintendo switch"
  ],
  "status": "on_sale",
  "sortBy": "relevance",
  "shippingPaidBy": "any",
  "sellerType": "any",
  "maxItems": 30,
  "includeDetails": true
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `summary` (type: `string`):

No description

# 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 = {
    "searchQueries": [
        "nintendo switch"
    ],
    "maxItems": 30
};

// Run the Actor and wait for it to finish
const run = await client.actor("themineworks/mercari-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 = {
    "searchQueries": ["nintendo switch"],
    "maxItems": 30,
}

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

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

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

```

## CLI example

```bash
echo '{
  "searchQueries": [
    "nintendo switch"
  ],
  "maxItems": 30
}' |
apify call themineworks/mercari-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,themineworks/mercari-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

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