# Mercari US Sold Listings Scraper (`devilscrapes/mercari-sold-listings`) Actor
Search Mercari US listings by keyword with a first-class sold/completed-listing filter โ one row per item with price, condition, brand, category, seller, and photos. Built for reseller-arbitrage comps. No login; we handle the retries.
- **URL**: https://apify.com/devilscrapes/mercari-sold-listings.md
- **Developed by:** [DevilScrapes](https://apify.com/devilscrapes) (community)
- **Categories:** E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $2.50 / 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/docs.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 US Sold Listings Scraper
**๐ฐ $2.51 / 1 000 results** ยท pay only for results ยท no credit card to try
_We do the dirty work so your dataset stays clean._ ๐
Search Mercari US listings by keyword with a first-class sold/completed-listing filter โ one row per item with price, condition, brand, category, seller, and photos. Built for reseller-arbitrage comps. No login; we handle the retries.
---
### ๐ฏ What this scrapes
Mercari US (`mercari.com`) doesn't publish a clean "sold comps" view โ resellers digging for real recent sale prices are stuck scrolling active listings. This Actor reads Mercari's own server-rendered category pages (the same pages Google indexes, not a private reverse-engineered endpoint) with a first-class **sold / completed-listing filter** and an optional sold-within-days window, so arbitrageurs and flippers get exactly the comps they need without wading through active inventory.
Give it a `keyword` โ optionally a `category`, a condition, a price band, and a "sold within the last N days" window โ and it hands back one clean row per matching item: price, condition, brand, category, seller, photos, and (optionally) exact listing/sold dates and seller rating.
### ๐ฅ What we handle for you
- ๐ก๏ธ **Browser fingerprint rotation** โ `curl-cffi` impersonates real Chrome / Firefox TLS handshakes so Mercari sees a browser, not Python.
- ๐ **Retries with exponential backoff** on rate-limits and transient errors โ up to 5 attempts, `Retry-After` honoured.
- ๐งฑ **Rate-limit-aware pacing** โ when the target pushes back, we slow down instead of getting banned.
- ๐ **Proxy on standby** โ `proxyConfiguration` is available as an escape hatch, ready to flip on if Mercari tightens later, with no code changes on your end.
- ๐ง **Clean, typed dataset rows** โ Pydantic-validated, ISO-8601 timestamps, stable item IDs, deduplicated even when a keyword fans out across departments.
- ๐ฐ **Pay-Per-Event pricing** โ you only pay for results that hit your dataset. No data, no charge (beyond the small `actor-start` warm-up fee).
### ๐ก Use cases
- **Reseller-arbitrage comps** โ check what an item actually sold for recently before buying stock to flip.
- **Liquidation / dropship pricing** โ price a pallet or lot against real completed Mercari sales, not asking prices.
- **Demand tracking** โ watch how fast a keyword's listings move from active to sold within a rolling window.
- **Sourcing research** โ see which condition and price bands are actually selling versus sitting active.
### โ๏ธ How to use it
1. Click **Try for free** at the top of the page.
2. Set `keyword` to whatever you're pricing (e.g. `"nintendo"`).
3. Optionally pick a `category` โ leave it unset to fan out across all 17 departments (uses more requests per run).
4. Turn on `soldOnly` and set `soldWithinDays` for a recent-comps window.
5. Turn on `includeDetails` if you want listing/sold dates and seller rating per row (one extra request per item).
6. Click **Start**. Rows stream into the run's dataset as they're found.
7. Export from **Storage โ Dataset** as JSON, CSV, or Excel โ or fetch via the API.
### ๐ฅ Input
| Field | Type | Required | Default | Notes |
|---|---|:--:|---|---|
| `keyword` | `string` | **yes** | โ | Free-text search term, e.g. `"nintendo"`. |
| `category` | `string` | no | fans out over all 17 | One Mercari department โ women, men, kids, home, vintage_collectibles, beauty, electronics, sports_outdoors, handmade, other, arts_crafts, books, pet_supplies, toys_collectibles, garden_outdoor, office, tools. |
| `conditionIds` | `array` | no | โ | 1=New โฆ 5=Poor. Applied client-side after fetch. |
| `priceMin` / `priceMax` | `number` | no | โ | USD. Applied client-side after fetch. |
| `soldOnly` | `boolean` | no | `false` | Only trading/sold_out listings โ Mercari's own "Sold" facet. |
| `soldWithinDays` | `integer` | no | โ | Only items sold in the last N days (1-365). Requires `soldOnly`. |
| `includeDetails` | `boolean` | no | `false` | Fetch each item's detail page for listing/sold dates + seller rating. |
| `maxResults` | `integer` | no | `100` | Cap on total emitted rows per run, 1-2000. |
| `proxyConfiguration` | `object` | no | `{"useApifyProxy": false}` | Not required for this target; kept as a forward-looking escape hatch. |
#### Example input
```json
{
"keyword": "nintendo",
"category": "men",
"soldOnly": true,
"soldWithinDays": 7,
"includeDetails": true,
"maxResults": 5,
"proxyConfiguration": { "useApifyProxy": false }
}
````
### ๐ค Output
One dataset row per matched item:
| Field | Type | Notes |
|---|---|---|
| `item_id` | `string` | Mercari's own item ID, e.g. `m96557170766`. |
| `title` | `string` | Listing title. |
| `price` / `original_price` | `number \| null` | Current / original asking price, USD. |
| `currency` | `string` | Always `"USD"`. |
| `status` | `string` | `on_sale`, `trading`, `sold_out`, `stop`, or `cancel`. |
| `sold` | `boolean` | Derived: `status` is `trading` or `sold_out`. |
| `condition` / `brand` | `string \| null` | Item condition and brand tag. |
| `category` / `category_id` | `string` / `integer` | The item's own (usually leaf-level) category โ not an echo of the requested department. |
| `seller_id` | `integer` | Seller's numeric Mercari ID. |
| `seller_username`, `seller_rating_avg`, `seller_rating_count` | mixed, nullable | Enrichment only (`includeDetails: true`). |
| `item_url` | `string` | Canonical `mercari.com/us/item/{id}/` URL. |
| `thumbnail_url` / `photo_urls` | `string \| null` / `array` | First photo, and the full photo list. |
| `shipping_payer` | `string \| null` | Who pays shipping. |
| `listing_date` / `sold_date` | `string \| null` | Enrichment only. `sold_date` is a last-status-change proxy, not a guaranteed sale instant. |
| `scraped_at` | `string` | ISO-8601 UTC timestamp for this row. |
#### Example output
```json
{
"item_id": "m96557170766",
"title": "Mario Hanafuda card T-shirt (Size XXL) - Nintendo Japan exclusive (NEW)",
"price": 59.0,
"original_price": 58.0,
"currency": "USD",
"status": "trading",
"sold": true,
"condition": "New",
"brand": "Nintendo",
"category": "T-Shirts for Men",
"category_id": 303,
"seller_id": 348351597,
"item_url": "https://www.mercari.com/us/item/m96557170766/",
"thumbnail_url": "https://u-mercari-images.mercdn.net/photos/m96557170766_1.jpg?1773934282&width=200&height=200",
"listing_date": null,
"sold_date": null,
"scraped_at": "2026-07-21T06:40:00.000Z"
}
```
### ๐ฐ Pricing
Pay-Per-Event โ you pay only when these events fire:
| Event | USD | What it is |
|---|---:|---|
| `actor-start` | $0.01 | One-off warm-up charge per run |
| `item-result` | $0.0025 | Per listing row written to the dataset |
| `item-detail-enrichment` | $0.0015 | Per row, only when `includeDetails` is on |
Example: 1 000 results โ **$2.51** base, โ **$4.01** with detail enrichment on. No subscription, no minimum, no card to start โ Apify gives every new account $5 of free credit.
### ๐ง Limitations
`sold_date` is a last-status-change proxy (the item detail page's own "updated" timestamp) โ not a guaranteed exact sale instant. Mercari retires sold-item history after roughly a year; older sold items return a purge signal and are skipped, not faked. `conditionIds` / `priceMin` / `priceMax` are applied client-side after fetch, not as a confirmed server-side filter โ a narrow filter combined with a broad keyword and no `category` can cost extra pagination. Custom sort order isn't supported; results follow Mercari's own default relevance ranking. Mercari Japan (`jp.mercari.com`) is a different site and out of scope.
### โ FAQ
**What counts as "sold" here?**
Mercari's own UI groups `itemStatuses` 2 (trading / in escrow) and 3 (sold\_out) under one "Sold" facet โ `soldOnly=true` matches that same definition, not just fully closed-out listings.
**Is `sold_date` the exact moment of sale?**
It's a proxy โ the item detail page's own last-updated timestamp, which moves when status flips to sold/trading. Close, not certified exact-to-the-second.
**Do I need a proxy?**
No โ Mercari's category pages are keyless and server-rendered, so `proxyConfiguration` defaults off. It stays present as a forward-looking escape hatch.
**What happens with old, purged sold items?**
Mercari retires sold-item history after roughly a year; those return a purge signal and are skipped, not silently faked.
### ๐ฌ Your feedback
Spotted a bug, a field that doesn't match reality, or a Mercari category we're missing? Open an issue on the Actor's **Issues** tab on Apify Console โ the devil's in the data, and we'd rather fix it than let it slide.
***
Built by **[Devil Scrapes](https://apify.com/DevilScrapes)** ๐ โ a small fleet of
opinionated public-data Actors. Honest pricing, real engineering, zero fine print.
# Actor input Schema
## `keyword` (type: `string`):
Free-text search term, e.g. "nintendo".
## `category` (type: `string`):
Restrict the search to one Mercari department. Leave unset to fan out across all 17 departments (uses more requests per run).
## `conditionIds` (type: `array`):
Client-side filter on item condition: 1=New, 2=Like new, 3=Good, 4=Fair, 5=Poor. Leave empty for any condition.
## `priceMin` (type: `number`):
Client-side filter โ drop rows priced below this, in USD.
## `priceMax` (type: `number`):
Client-side filter โ drop rows priced above this, in USD.
## `soldOnly` (type: `boolean`):
When on, only trading/sold\_out listings are returned โ Mercari's own "Sold" facet.
## `soldWithinDays` (type: `integer`):
Only include items sold in the last N days (1-365). Requires "Sold listings only".
## `includeDetails` (type: `boolean`):
Fetch each item's detail page for listing date, sold date, and seller username/rating. One extra request per row.
## `maxResults` (type: `integer`):
Cap on total emitted rows per run.
## `proxyConfiguration` (type: `object`):
Not required for this target โ Mercari's category pages are keyless and server-rendered. Present as a forward-looking escape hatch.
## Actor input object example
```json
{
"keyword": "nintendo",
"category": "men",
"soldOnly": true,
"soldWithinDays": 7,
"includeDetails": false,
"maxResults": 100,
"proxyConfiguration": {
"useApifyProxy": false
}
}
```
# Actor output Schema
## `datasetItems` (type: `string`):
All dataset items as JSON.
## `datasetItemsCsv` (type: `string`):
Same data exported to CSV.
## `datasetView` (type: `string`):
Open the run dataset in the Console.
# 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 = {
"keyword": "nintendo",
"category": "men",
"soldOnly": true,
"soldWithinDays": 7,
"maxResults": 100,
"proxyConfiguration": {
"useApifyProxy": false
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("devilscrapes/mercari-sold-listings").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 = {
"keyword": "nintendo",
"category": "men",
"soldOnly": True,
"soldWithinDays": 7,
"maxResults": 100,
"proxyConfiguration": { "useApifyProxy": False },
}
# Run the Actor and wait for it to finish
run = client.actor("devilscrapes/mercari-sold-listings").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 '{
"keyword": "nintendo",
"category": "men",
"soldOnly": true,
"soldWithinDays": 7,
"maxResults": 100,
"proxyConfiguration": {
"useApifyProxy": false
}
}' |
apify call devilscrapes/mercari-sold-listings --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=devilscrapes/mercari-sold-listings",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Mercari US Sold Listings Scraper",
"description": "Search Mercari US listings by keyword with a first-class sold/completed-listing filter โ one row per item with price, condition, brand, category, seller, and photos. Built for reseller-arbitrage comps. No login; we handle the retries.",
"version": "0.0",
"x-build-id": "wmIrryY1FVEmzw42m"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/devilscrapes~mercari-sold-listings/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-devilscrapes-mercari-sold-listings",
"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/devilscrapes~mercari-sold-listings/runs": {
"post": {
"operationId": "runs-sync-devilscrapes-mercari-sold-listings",
"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/devilscrapes~mercari-sold-listings/run-sync": {
"post": {
"operationId": "run-sync-devilscrapes-mercari-sold-listings",
"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",
"required": [
"keyword"
],
"properties": {
"keyword": {
"title": "Keyword",
"type": "string",
"description": "Free-text search term, e.g. \"nintendo\"."
},
"category": {
"title": "Category",
"enum": [
"women",
"men",
"kids",
"home",
"vintage_collectibles",
"beauty",
"electronics",
"sports_outdoors",
"handmade",
"other",
"arts_crafts",
"books",
"pet_supplies",
"toys_collectibles",
"garden_outdoor",
"office",
"tools"
],
"type": "string",
"description": "Restrict the search to one Mercari department. Leave unset to fan out across all 17 departments (uses more requests per run)."
},
"conditionIds": {
"title": "Condition IDs",
"type": "array",
"description": "Client-side filter on item condition: 1=New, 2=Like new, 3=Good, 4=Fair, 5=Poor. Leave empty for any condition.",
"items": {
"type": "integer",
"minimum": 1,
"maximum": 5
}
},
"priceMin": {
"title": "Minimum price (USD)",
"minimum": 0,
"type": "number",
"description": "Client-side filter โ drop rows priced below this, in USD."
},
"priceMax": {
"title": "Maximum price (USD)",
"minimum": 0,
"type": "number",
"description": "Client-side filter โ drop rows priced above this, in USD."
},
"soldOnly": {
"title": "Sold listings only",
"type": "boolean",
"description": "When on, only trading/sold_out listings are returned โ Mercari's own \"Sold\" facet.",
"default": false
},
"soldWithinDays": {
"title": "Sold within days",
"minimum": 1,
"maximum": 365,
"type": "integer",
"description": "Only include items sold in the last N days (1-365). Requires \"Sold listings only\"."
},
"includeDetails": {
"title": "Include per-item details",
"type": "boolean",
"description": "Fetch each item's detail page for listing date, sold date, and seller username/rating. One extra request per row.",
"default": false
},
"maxResults": {
"title": "Max results",
"minimum": 1,
"maximum": 2000,
"type": "integer",
"description": "Cap on total emitted rows per run.",
"default": 100
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Not required for this target โ Mercari's category pages are keyless and server-rendered. Present as a forward-looking escape hatch.",
"default": {
"useApifyProxy": false
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```