# Mercari Japan Scraper – Listings & Sold Comps (`datalab-jp/mercari-scraper`) Actor Scrape listings and real sold prices from Mercari Japan, the largest C2C marketplace. Get titles, prices, condition, sold status, seller, and images as JSON. Filter to sold-only for price research, or combine with our Yahoo! Auctions and Rakuma scrapers for cross-marketplace comps. - **URL**: https://apify.com/datalab-jp/mercari-scraper.md - **Developed by:** [Task Data](https://apify.com/datalab-jp) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 Japan Scraper – Listings & Sold Comps Extract **listing titles, prices, condition, sold status, seller, and images** from [Mercari Japan](https://jp.mercari.com/) — Japan's largest consumer-to-consumer (C2C) marketplace. Built for **international resellers, price researchers, market analysts, and AI agents** that need structured Japanese resale data without writing a scraper or logging in. No coding required: enter a keyword, run, and get clean JSON. A key feature is **sold-only filtering** — you get *actual transaction prices* (sold comps), not just asking prices — so you can measure what items really sell for in Japan. ### What data can you extract? | Field | Description | |-------|-------------| | `itemId` | Mercari item ID (e.g. `m46709580221`) | | `title` | Listing title (Japanese) | | `price` | Price in Japanese yen (JPY) | | `status` | `selling`, `trading` (mid-transaction), or `sold` | | `condition` | Japanese condition grade (e.g. 未使用に近い) | | `categoryId` | Mercari category ID | | `sellerId` | Seller ID | | `imageUrl` | Thumbnail image URL | | `url` | Direct link to the listing | | `createdAt` / `updatedAt` | Listing timestamps (ISO 8601) | ### Why scrape Mercari Japan? - **Sold-price research (comps)** — find what items *actually sold for*, not just asking prices, by filtering to `sold_out`. - **Cross-marketplace price comparison** — Mercari is the natural third leg alongside Yahoo! Auctions and Rakuma / Yahoo! Flea Market. Combine all three for a complete picture of Japanese resale value (same output shape across our Actors). - **Sourcing & arbitrage** — spot underpriced listings for a brand, character, or franchise to resell abroad. - **Trend & demand tracking** — monitor prices and volume for a product line over time. - **AI agents / RAG** — feed structured Japanese marketplace data into an LLM workflow. This Actor is discoverable and callable through the [Apify MCP server](https://mcp.apify.com/). ### How to use it (no coding) 1. Click **Try for free / Start**. 2. Enter a **Search keyword** (Japanese works best, e.g. `ポケモンカード`). 3. Optionally set **Listing status** to `Sold only` for price research, add a price range, or change the sort order. 4. Click **Start** and download the results as JSON, CSV, or Excel — or pull them via the API (below). ### Input example ```json { "searchKeyword": "ポケモンカード", "status": "sold_out", "sortBy": "created", "priceMin": 1000, "maxItems": 100 } ```` All fields are optional — running with no input uses sensible defaults (keyword `ポケモンカード`, all statuses, 100 items). ### Output example Each result is one listing: ```json { "itemId": "m46709580221", "title": "ピカチュウ ● 第2弾拡張パック ポケモンジャングル", "price": 6000, "currency": "JPY", "status": "trading", "condition": "未使用に近い", "categoryId": "1289", "sellerId": "384902481", "imageUrl": "https://static.mercdn.net/thumb/item/webp/m46709580221_1.jpg?1783005384", "url": "https://jp.mercari.com/item/m46709580221", "createdAt": "2026-07-02T15:16:24.000Z", "updatedAt": "2026-07-10T15:18:39.000Z", "keyword": "ポケモンカード", "scrapedAt": "2026-07-10T16:30:45.752Z" } ``` Field notes: - `status` — `"selling"`, `"trading"` (mid-transaction, not yet confirmed sold), or `"sold"`. - `condition` — Japanese condition label (新品、未使用 / 未使用に近い / 目立った傷や汚れなし / やや傷や汚れあり / 傷や汚れあり / 全体的に状態が悪い). ### How much does it cost? This Actor uses **pay-per-event** pricing: a small charge when a run starts, plus a per-result charge for each item returned. You only pay for the data you actually receive, so a 100-item run costs about the price of 100 results. Use `maxItems` to cap your spend. ### Integrations: API, MCP, and AI agents This Actor is **read-only**: it only reads publicly available listings and performs no login, purchase, or write actions — safe for autonomous agents to call. #### API (curl) ```bash curl -X POST "https://api.apify.com/v2/acts/datalab-jp~mercari-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{"searchKeyword": "ポケモンカード", "status": "sold_out", "maxItems": 50}' ``` > Synchronous runs time out after 300 seconds. For large scrapes, use the standard [run endpoint](https://docs.apify.com/api/v2/act-runs-post) and fetch the dataset afterwards. #### Python (apify-client) ```python from apify_client import ApifyClient client = ApifyClient("YOUR_APIFY_TOKEN") run = client.actor("datalab-jp/mercari-scraper").call(run_input={ "searchKeyword": "ポケモンカード", "status": "sold_out", "maxItems": 50, }) items = client.dataset(run["defaultDatasetId"]).list_items().items print(items) ``` #### JavaScript (apify-client) ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' }); const run = await client.actor('datalab-jp/mercari-scraper').call({ searchKeyword: 'ポケモンカード', status: 'sold_out', maxItems: 50, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); ``` #### MCP / AI agents This Actor is available through the [Apify MCP server](https://mcp.apify.com/). AI agents (Claude, and any MCP-compatible client) can discover it with `search-actors`, inspect its inputs with `fetch-actor-details`, and run it with `call-actor` — no manual setup on your side. ### Related Actors Part of a family of **Japanese second-hand & resale market** scrapers with a consistent output shape, so you can combine them for cross-marketplace comps: - **Yahoo! Auctions Sold Scraper** — sold-price history from Japan's largest auction site - **Japan Flea Market Scraper** — Rakuma & Yahoo! Flea Market listings - **Suruga-ya Scraper** — used hobby goods, figures, and collectibles - **CardRush TCG Price Scraper** — trading card prices across 9 card games (Pokémon, One Piece, etc.) - **Melonbooks Scraper** — doujin goods and otaku merchandise ### FAQ **Is scraping Mercari legal?** This Actor collects only **publicly available** listing data through Mercari's own search API — the same endpoint the website uses. It does not log in, bypass paywalls, or collect private personal data. You are responsible for using the data in accordance with applicable laws and Mercari's terms of service. **Can I call this Actor from my own app or API?** Yes. Use the Apify API or the `apify-client` libraries shown above. Every run returns a dataset you can fetch as JSON, CSV, or Excel. **Can AI agents use this Actor?** Yes. It is exposed through the Apify MCP server, so agents can find and run it automatically. It is read-only and safe to call. **Why does it use a residential proxy by default?** Mercari's search API blocks datacenter IPs in some cases, so a Japan-based residential proxy is used by default for reliability. You can override this in the proxy configuration, but datacenter proxies may be blocked. **How do I get real sold prices instead of asking prices?** Set **Listing status** to `Sold only (price research)` (`sold_out`). This returns completed sales — the actual amounts items sold for. ### Disclaimer This Actor collects **publicly available** listing data only, via Mercari's own search API, authenticating requests with a fresh, ephemeral key generated per run — no login credentials or private tokens are used. Use responsibly and in accordance with applicable laws and Mercari's terms. # Actor input Schema ## `searchKeyword` (type: `string`): Keyword to search for on Mercari Japan, e.g. 'ポケモンカード' (Pokémon cards) or 'ガンプラ' (Gundam model kits). Japanese keywords return the most results because Mercari is a Japanese marketplace, but English brand names such as 'Nintendo Switch' or 'Supreme' also work. Each matching listing becomes one row in the output dataset (one billable result). Set the `status` field to 'sold\_out' to research real sold prices instead of asking prices. ## `status` (type: `string`): Filter results by listing status. 'all' returns every matching listing (default). 'on\_sale' returns only items currently for sale, which is best for sourcing and checking current stock. 'sold\_out' returns only completed sales, i.e. actual transaction prices — use this for sold-price and comps research rather than asking prices. If omitted, defaults to 'all'. ## `sortBy` (type: `string`): Sort order for the results, mirroring the sort options on the Mercari website. 'score' is Mercari's recommended relevance ranking (default). 'created' sorts newest listings first. 'priceHigh' and 'priceLow' sort by price descending and ascending. 'likes' sorts most-liked first. If omitted, defaults to 'score'. ## `priceMin` (type: `integer`): Optional lower price bound in Japanese yen (JPY). Only listings priced at or above this amount are returned — for example, set it to 1000 to exclude cheap accessories. Leave empty to apply no minimum. Works together with `priceMax` to define a price range. ## `priceMax` (type: `integer`): Optional upper price bound in Japanese yen (JPY). Only listings priced at or below this amount are returned — for example, set it to 5000 to focus on budget items. Leave empty to apply no maximum. Works together with `priceMin` to define a price range. ## `maxItems` (type: `integer`): Maximum number of listings to return across all pages. Each returned item is one billable result, so this is the main cost control. Defaults to 100 if omitted, and accepts values from 1 to 5000. The Actor paginates automatically and stops once this limit is reached or there are no more matching results. ## `proxyConfiguration` (type: `object`): Apify Proxy configuration. Mercari's search API sits behind bot detection that has blocked datacenter IPs for other Japanese marketplaces from this account, so this Actor defaults to a Japan-based residential proxy (RESIDENTIAL group, country JP) for reliability. You can override the group or country here, but datacenter proxies may be blocked. Note that residential proxy traffic costs more per GB than datacenter proxy. ## Actor input object example ```json { "searchKeyword": "ポケモンカード", "status": "all", "sortBy": "score", "maxItems": 100, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "JP" } } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchKeyword": "ポケモンカード", "status": "all", "sortBy": "score" }; // Run the Actor and wait for it to finish const run = await client.actor("datalab-jp/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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchKeyword": "ポケモンカード", "status": "all", "sortBy": "score", } # Run the Actor and wait for it to finish run = client.actor("datalab-jp/mercari-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 '{ "searchKeyword": "ポケモンカード", "status": "all", "sortBy": "score" }' | apify call datalab-jp/mercari-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=datalab-jp/mercari-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Mercari Japan Scraper – Listings & Sold Comps", "description": "Scrape listings and real sold prices from Mercari Japan, the largest C2C marketplace. Get titles, prices, condition, sold status, seller, and images as JSON. Filter to sold-only for price research, or combine with our Yahoo! Auctions and Rakuma scrapers for cross-marketplace comps.", "version": "0.0", "x-build-id": "r62Sw1dBwliLtc8F9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datalab-jp~mercari-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datalab-jp-mercari-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/datalab-jp~mercari-scraper/runs": { "post": { "operationId": "runs-sync-datalab-jp-mercari-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/datalab-jp~mercari-scraper/run-sync": { "post": { "operationId": "run-sync-datalab-jp-mercari-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchKeyword": { "title": "Search keyword", "type": "string", "description": "Keyword to search for on Mercari Japan, e.g. 'ポケモンカード' (Pokémon cards) or 'ガンプラ' (Gundam model kits). Japanese keywords return the most results because Mercari is a Japanese marketplace, but English brand names such as 'Nintendo Switch' or 'Supreme' also work. Each matching listing becomes one row in the output dataset (one billable result). Set the `status` field to 'sold_out' to research real sold prices instead of asking prices.", "default": "ポケモンカード" }, "status": { "title": "Listing status", "enum": [ "all", "on_sale", "sold_out" ], "type": "string", "description": "Filter results by listing status. 'all' returns every matching listing (default). 'on_sale' returns only items currently for sale, which is best for sourcing and checking current stock. 'sold_out' returns only completed sales, i.e. actual transaction prices — use this for sold-price and comps research rather than asking prices. If omitted, defaults to 'all'.", "default": "all" }, "sortBy": { "title": "Sort by", "enum": [ "score", "created", "priceHigh", "priceLow", "likes" ], "type": "string", "description": "Sort order for the results, mirroring the sort options on the Mercari website. 'score' is Mercari's recommended relevance ranking (default). 'created' sorts newest listings first. 'priceHigh' and 'priceLow' sort by price descending and ascending. 'likes' sorts most-liked first. If omitted, defaults to 'score'.", "default": "score" }, "priceMin": { "title": "Minimum price (JPY, optional)", "type": "integer", "description": "Optional lower price bound in Japanese yen (JPY). Only listings priced at or above this amount are returned — for example, set it to 1000 to exclude cheap accessories. Leave empty to apply no minimum. Works together with `priceMax` to define a price range." }, "priceMax": { "title": "Maximum price (JPY, optional)", "type": "integer", "description": "Optional upper price bound in Japanese yen (JPY). Only listings priced at or below this amount are returned — for example, set it to 5000 to focus on budget items. Leave empty to apply no maximum. Works together with `priceMin` to define a price range." }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of listings to return across all pages. Each returned item is one billable result, so this is the main cost control. Defaults to 100 if omitted, and accepts values from 1 to 5000. The Actor paginates automatically and stops once this limit is reached or there are no more matching results.", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy configuration. Mercari's search API sits behind bot detection that has blocked datacenter IPs for other Japanese marketplaces from this account, so this Actor defaults to a Japan-based residential proxy (RESIDENTIAL group, country JP) for reliability. You can override the group or country here, but datacenter proxies may be blocked. Note that residential proxy traffic costs more per GB than datacenter proxy.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "JP" } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```