# Mercari Seller Scraper: Shop Listings, Ratings & Item History (`getascraper/mercari-seller-scraper`) Actor Scrape any Mercari Japan seller's full shop: profile rating, review count, followers, and all active/sold listings with JPY price, condition, and category. No login required. - **URL**: https://apify.com/getascraper/mercari-seller-scraper.md - **Developed by:** [GetAScraper](https://apify.com/getascraper) (community) - **Categories:** E-commerce, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.34 / 1,000 seller records 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/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 Seller Scraper: Shop Listings, Ratings & Item History
Pull a complete dossier on any Mercari Japan or US seller in one run. Get a seller's rating score, review count, followers, and every listing, active or sold, with price, condition, and category. Covers both Mercari Japan (jp.mercari.com) and Mercari US (mercari.com). Built for resellers, sourcing analysts, and competitive intelligence teams who need Mercari seller and shop data without manual browsing.
Mercari (メルカリ) suite   •  Listings, sold comps, and sellers across Mercari Japan and US
 Seller Scraper
➤ You are here 		 Japan Scraper
Listings, price and condition 		 US Scraper
Sold prices and sellers 		 Sold Comps
Sold prices and sell-through
### What does Mercari Seller Scraper do? This Actor accepts one or more Mercari seller IDs or full profile URLs and returns two record types for each seller: a profile row (name, rating score, review count, follower count, listing counts) and one row per listing (title, price in the region's currency, condition, status, category, thumbnail). It covers both **Mercari Japan** (jp.mercari.com) and **Mercari US** (mercari.com). It scrolls each shop automatically, deduplicates across sellers, and stops when your per-seller limit is reached. Runs can be scheduled, triggered through the API, streamed into Google Sheets, or exported as CSV, JSON, or Excel.
⚡ The whole shop in one run. No account or login required. Get a seller's profile stats plus every listing, active and sold, ready to schedule for daily monitoring of new drops and price changes.
### Why use Mercari Seller Scraper? "I needed to monitor five resellers to see when they drop new inventory. This saved me hours of manual checking every week." "We screen suppliers on Mercari Japan before negotiating. Rating score plus sold history tells us whether they are worth contacting." - **Sourcing due diligence**: validate a Mercari seller's track record before placing bulk orders. Review count, rating score, and sold history in one dataset. - **Competitive monitoring**: track what a competing reseller lists and at what price. Schedule daily runs to catch new drops. - **Inventory analysis**: map which categories a seller specialises in and how fast items move from on-sale to sold. - **Market research**: aggregate seller data across a niche to understand pricing norms and supply depth on Mercari Japan or US. ### How to use Mercari Seller Scraper 1. Open the Actor in Apify Console and click Try for free. 2. In the Input tab, select your region (Japan or US). 3. Paste one or more seller IDs or full profile URLs for the chosen region. 4. Set Max listings per seller (default 500) and choose whether to include sold items. 5. Enable Apify Proxy. For US, the Actor automatically forces a US residential proxy. 6. Click Start. A seller profile row appears first, followed by listing rows as they are collected. 7. Download results from the Dataset tab in JSON, CSV, Excel, or HTML, or connect through the API. ### Input At least one of `sellerIds` or `sellerUrls` is required. | Field | Type | Required | Description | |---|---|---|---| | `sellerIds` | array of strings | Yes* | Seller IDs. Japan: alphanumeric string from the profile URL, e.g. `629110147`. US: numeric ID from `https://www.mercari.com/u/{id}/`. | | `sellerUrls` | array of URLs | Yes* | Full seller profile URLs. Japan: `https://jp.mercari.com/en/user/profile/629110147`. US: `https://www.mercari.com/u/123456789/`. | | `maxListingsPerSeller` | integer | No | Maximum listings to collect per seller. Default is 500. | | `includeSold` | boolean | No | When true, both active and sold listings are returned. Set to false for active only. Default is true. | | `region` | enum | No | `JAPAN` (default, jp.mercari.com) or `US` (mercari.com). US requires a US residential proxy. | | `proxyConfiguration` | object | No | Proxy settings. Japan: Apify Proxy datacenter is sufficient. US: the Actor automatically forces a US residential proxy unless custom proxy URLs are supplied. | `*` Provide at least one of `sellerIds` or `sellerUrls`. ### Output Each run produces two record types in the same dataset. Download as JSON, HTML, CSV, or Excel. **Seller profile row** (`recordType: "seller"`): ```json { "recordType": "seller", "sellerId": "629110147", "sellerName": "vintage_tokyo_store", "profileUrl": "https://jp.mercari.com/en/user/profile/629110147", "ratingScore": 4.8, "numRatings": 312, "numListings": 47, "numSold": 890, "followers": 128, "scrapedAt": "2026-07-01T10:00:00.000Z" } ```` **Listing row** (`recordType: "listing"`) -- Japan: ```json { "recordType": "listing", "sellerId": "629110147", "listingId": "m66939329940", "title": "Apple Watch Series 4 44mm", "price": 5000, "priceJpy": 5000, "currency": "JPY", "status": "on_sale", "conditionId": "3", "categoryId": "3676", "url": "https://jp.mercari.com/item/m66939329940", "thumbnailUrl": "https://static.mercdn.net/thumb/item/webp/m66939329940_1.jpg", "listedAt": "2026-06-15T08:22:11Z", "scrapedAt": "2026-07-01T10:00:00.000Z" } ``` **Listing row** (`recordType: "listing"`) -- US: ```json { "recordType": "listing", "sellerId": "123456789", "listingId": "m99123456789", "title": "Nike Air Max 90 Size 10", "price": 75.00, "currency": "USD", "status": "on_sale", "conditionId": "3", "categoryId": "29", "url": "https://www.mercari.com/us/item/m99123456789/", "thumbnailUrl": "https://static.mercdn.net/item/detail/orig/photos/m99123456789_1.jpg", "listedAt": "2026-06-20T14:30:00Z", "scrapedAt": "2026-07-01T10:00:00.000Z" } ``` ### Data table | Field | Type | Description | |---|---|---| | `recordType` | string | `"seller"` for profile rows, `"listing"` for item rows. | | `sellerId` | string | Mercari seller account ID. | | `sellerName` | string | Display name on the profile page (seller rows). | | `profileUrl` | string | Full URL of the seller's profile (seller rows). | | `ratingScore` | number | Rating score, e.g. 4.8 (seller rows). | | `numRatings` | number | Total reviews received (seller rows). | | `numListings` | number | Active listings currently in the shop (seller rows). | | `numSold` | number | Total items sold shown on the profile (seller rows). | | `followers` | number | Follower count (seller rows). | | `listingId` | string | Mercari item ID (listing rows). | | `title` | string | Item title (listing rows). | | `price` | number | Listing price in the row's currency: JPY for Japan, USD for US (listing rows). | | `priceJpy` | number | Listed price in Japanese Yen. Japan only -- absent on US rows (listing rows). | | `currency` | string | `JPY` for Japan rows, `USD` for US rows. | | `status` | string | `on_sale`, `sold_out`, or `trading` (listing rows). | | `conditionId` | string | Condition code: 1 = new, 2 = like new, 3 = good, 4 = fair, 5 = poor. | | `categoryId` | string | Mercari category identifier (listing rows). | | `url` | string | Full listing URL (listing rows). | | `thumbnailUrl` | string | Primary thumbnail image URL (listing rows). | | `listedAt` | string | ISO timestamp when the item was first listed (listing rows). | | `scrapedAt` | string | ISO timestamp when the row was collected. | ### How much does it cost to scrape a Mercari seller? Pricing is pay per result. You are charged only for the rows the Actor returns, so an empty run costs nothing. There are no monthly subscriptions and no minimum spend. A run collects one profile row per seller plus one row per listing in their shop. ### Tips - **Find a Japan seller ID**: open any seller's profile on jp.mercari.com. The ID is the last part of the URL: `https://jp.mercari.com/en/user/profile/629110147` gives ID `629110147`. - **Find a US seller ID**: open any seller's profile on mercari.com. The ID is the part after `/u/`: `https://www.mercari.com/u/123456789/` gives ID `123456789`. - **US proxy**: the Actor automatically forces a US residential proxy for US runs. Make sure your Apify plan includes the RESIDENTIAL proxy group. - **Monitor new listings**: schedule this Actor to run daily on the same seller IDs, then compare datasets to see which items were added or sold. - **Active listings only**: set `includeSold` to false to skip sold items and cut run time. - **Multiple sellers at once**: add all IDs to `sellerIds` in one run. The Actor processes them in turn and deduplicates listing IDs across sellers. - **Combine with the** [Mercari Sold Comps Scraper](https://apify.com/getascraper/mercari-sold-comps-scraper) to turn a seller's sold history into price comps. ### FAQ #### How do I find a Japan seller ID? Open the seller's profile page on jp.mercari.com. The ID is the last part of the URL, for example `629110147` in `https://jp.mercari.com/en/user/profile/629110147`. #### How do I find a US seller ID? Open the seller's profile page on mercari.com. The ID follows `/u/` in the URL, for example `123456789` in `https://www.mercari.com/u/123456789/`. #### Why are some US profile fields missing? US profile data (rating, sold count, followers) is extracted from the page's embedded JSON on a best-effort basis. Mercari US does not expose all fields in the same way as Japan. Fields that cannot be found are omitted rather than guessed. #### Why are some Japan profile fields missing? Seller profile fields are read from the public profile page. When a seller has no ratings or followers, those fields are returned empty rather than guessed. #### Are sold listings included? Yes, by default. Set `includeSold` to false to return only active listings. #### Do I need a Mercari account or login? No. The Actor reads only publicly visible seller and listing data. No login or cookies are required. #### Is it legal to scrape Mercari data? This Actor collects publicly visible data from jp.mercari.com and mercari.com for research and analysis. You are responsible for following Mercari's terms of service and any applicable data-protection laws. Do not use collected data to contact individuals or for prohibited purposes. #### Found a problem or need another field? Open a ticket on the Issues tab of this Actor. Custom solutions and additional fields are available on request. # Actor input Schema ## `sellerIds` (type: `array`): One or more Mercari seller IDs (the alphanumeric string in the profile URL). For Japan: e.g. '629110147'. For US: the ID from https://www.mercari.com/u/{id}/. Use this OR Seller Profile URLs below. ## `sellerUrls` (type: `array`): One or more full Mercari seller profile URLs. Japan example: https://jp.mercari.com/en/user/profile/629110147. US example: https://www.mercari.com/u/123456789/. The seller ID is extracted automatically. ## `maxListingsPerSeller` (type: `integer`): Maximum number of listings to collect per seller. Default is 500. ## `includeSold` (type: `boolean`): When enabled (default), both active and sold listings are collected. Disable to return only items currently on sale. ## `region` (type: `string`): Marketplace region. JAPAN scrapes jp.mercari.com (default). US scrapes www.mercari.com and requires a US residential proxy — enable Apify Proxy with RESIDENTIAL group and country US. ## `proxyConfiguration` (type: `object`): Proxy settings. For Japan, Apify Proxy (datacenter) is sufficient. For US, a US residential proxy is required — the Actor forces RESIDENTIAL US automatically unless you supply custom proxy URLs. ## Actor input object example ```json { "sellerIds": [ "629110147" ], "sellerUrls": [ { "url": "https://jp.mercari.com/en/user/profile/629110147" } ], "maxListingsPerSeller": 500, "includeSold": true, "region": "JAPAN", "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `results` (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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "sellerIds": [ "629110147" ], "sellerUrls": [ { "url": "https://jp.mercari.com/en/user/profile/629110147" } ], "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("getascraper/mercari-seller-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 = { "sellerIds": ["629110147"], "sellerUrls": [{ "url": "https://jp.mercari.com/en/user/profile/629110147" }], "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("getascraper/mercari-seller-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 '{ "sellerIds": [ "629110147" ], "sellerUrls": [ { "url": "https://jp.mercari.com/en/user/profile/629110147" } ], "proxyConfiguration": { "useApifyProxy": true } }' | apify call getascraper/mercari-seller-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=getascraper/mercari-seller-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Mercari Seller Scraper: Shop Listings, Ratings & Item History", "description": "Scrape any Mercari Japan seller's full shop: profile rating, review count, followers, and all active/sold listings with JPY price, condition, and category. No login required.", "version": "1.0", "x-build-id": "ksGpG99bxCUeaWryT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~mercari-seller-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-mercari-seller-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/getascraper~mercari-seller-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-mercari-seller-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/getascraper~mercari-seller-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-mercari-seller-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": { "sellerIds": { "title": "Seller IDs", "type": "array", "description": "One or more Mercari seller IDs (the alphanumeric string in the profile URL). For Japan: e.g. '629110147'. For US: the ID from https://www.mercari.com/u/{id}/. Use this OR Seller Profile URLs below.", "default": [], "items": { "type": "string" } }, "sellerUrls": { "title": "Seller Profile URLs", "type": "array", "description": "One or more full Mercari seller profile URLs. Japan example: https://jp.mercari.com/en/user/profile/629110147. US example: https://www.mercari.com/u/123456789/. The seller ID is extracted automatically.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxListingsPerSeller": { "title": "Max listings per seller", "minimum": 1, "type": "integer", "description": "Maximum number of listings to collect per seller. Default is 500.", "default": 500 }, "includeSold": { "title": "Include sold listings", "type": "boolean", "description": "When enabled (default), both active and sold listings are collected. Disable to return only items currently on sale.", "default": true }, "region": { "title": "Region", "enum": [ "JAPAN", "US" ], "type": "string", "description": "Marketplace region. JAPAN scrapes jp.mercari.com (default). US scrapes www.mercari.com and requires a US residential proxy — enable Apify Proxy with RESIDENTIAL group and country US.", "default": "JAPAN" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. For Japan, Apify Proxy (datacenter) is sufficient. For US, a US residential proxy is required — the Actor forces RESIDENTIAL US automatically unless you supply custom proxy URLs.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } } ```