# Mercari US Scraper: Sold Prices, Conditions & Sellers (`getascraper/mercari-us-scraper`) Actor

Scrape Mercari US (mercari.com) active and sold listings. Extract clean price, shipping, condition, and seller details directly as pages load. US proxy configuration included.

- **URL**: https://apify.com/getascraper/mercari-us-scraper.md
- **Developed by:** [GetAScraper](https://apify.com/getascraper) (community)
- **Categories:** AI, E-commerce, Automation
- **Stats:** 22 total users, 6 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $2.24 / 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?

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

## How to integrate an Actor?

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

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

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

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

# README

## 🛍️ Mercari US Scraper: Sold Prices, Conditions & Sellers

<table width="100%">
<tr>
<td colspan="4" style="padding:14px 18px;background:#FDECEA;border-top:3px solid #FF2019;border-left:1px solid #D6D3D1;border-right:1px solid #D6D3D1;border-radius:8px 8px 0 0">
<span style="font-size:16px;font-weight:700;color:#1C1917">Scrape active and sold Mercari US listings in one run.</span> <span style="font-size:15px;color:#57534E">Get clean USD price, condition, listing status, seller, shipping fee, and photo URLs for every result on mercari.com. Built for resellers, pricing analysts, and store owners who need Mercari US data in bulk without manual exports or fragile scraper keys.</span>
</td>
</tr>
<tr>
<td colspan="4" style="padding:10px 14px;background:#C41A0F;border-left:1px solid #D6D3D1;border-right:1px solid #D6D3D1">
<span style="color:#FFFFFF;font-size:14px;font-weight:700;letter-spacing:0.5px">Mercari (メルカリ) suite</span>
<span style="color:#FADBD8;font-size:13px">&nbsp;&nbsp;&bull;&nbsp;&nbsp;Listings, sold comps, and sellers across Mercari Japan and US</span>
</td>
</tr>
<tr>
<td style="padding:10px 12px;border-left:1px solid #D6D3D1;border-bottom:1px solid #D6D3D1;vertical-align:top;width:25%;background:#FFFFFF;border-radius:0 0 0 8px">
<span style="white-space:nowrap"><img src="https://images.apifyusercontent.com/ObXkeVa5KUb-Wc5lL9kGTvTDSxQ0ckP4sADzYCnmG_U/rs:fill:76:76/cb:1/aHR0cHM6Ly9hcGlmeS1pbWFnZS11cGxvYWRzLXByb2QuczMudXMtZWFzdC0xLmFtYXpvbmF3cy5jb20vak5EYkZhYmJWeE1oblFOYjQtYWN0b3ItZ212QlpnZ3ltd24zc3ZVdEgtb3VJSjVoRk1GbC1pY29uLndlYnA.webp" width="20" height="20" style="vertical-align:middle;border-radius:4px"> &nbsp;<a href="https://apify.com/getascraper/mercari-seller-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:13px">Seller&nbsp;Scraper</a></span><br>
<span style="color:#57534E;font-size:11px">Shop profile and listings</span>
</td>
<td style="padding:10px 12px;border-left:1px solid #D6D3D1;border-bottom:1px solid #D6D3D1;vertical-align:top;width:25%;background:#FFFFFF">
<span style="white-space:nowrap"><img src="https://images.apifyusercontent.com/ObXkeVa5KUb-Wc5lL9kGTvTDSxQ0ckP4sADzYCnmG_U/rs:fill:76:76/cb:1/aHR0cHM6Ly9hcGlmeS1pbWFnZS11cGxvYWRzLXByb2QuczMudXMtZWFzdC0xLmFtYXpvbmF3cy5jb20vak5EYkZhYmJWeE1oblFOYjQtYWN0b3ItZ212QlpnZ3ltd24zc3ZVdEgtb3VJSjVoRk1GbC1pY29uLndlYnA.webp" width="20" height="20" style="vertical-align:middle;border-radius:4px"> &nbsp;<a href="https://apify.com/getascraper/mercari-japan-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:13px">Japan&nbsp;Scraper</a></span><br>
<span style="color:#57534E;font-size:11px">Listings, price and condition</span>
</td>
<td style="padding:10px 12px;border-left:1px solid #D6D3D1;border-bottom:1px solid #D6D3D1;vertical-align:top;width:25%;background:#FDECEA">
<span style="white-space:nowrap"><img src="https://images.apifyusercontent.com/ObXkeVa5KUb-Wc5lL9kGTvTDSxQ0ckP4sADzYCnmG_U/rs:fill:76:76/cb:1/aHR0cHM6Ly9hcGlmeS1pbWFnZS11cGxvYWRzLXByb2QuczMudXMtZWFzdC0xLmFtYXpvbmF3cy5jb20vak5EYkZhYmJWeE1oblFOYjQtYWN0b3ItZ212QlpnZ3ltd24zc3ZVdEgtb3VJSjVoRk1GbC1pY29uLndlYnA.webp" width="20" height="20" style="vertical-align:middle;border-radius:4px"> &nbsp;<a href="https://apify.com/getascraper/mercari-us-scraper" style="color:#C41A0F;text-decoration:none;font-weight:700;font-size:13px">US&nbsp;Scraper</a></span><br>
<span style="color:#C41A0F;font-size:11px;font-weight:700">&#10148; You are here</span>
</td>
<td style="padding:10px 12px;border-left:1px solid #D6D3D1;border-right:1px solid #D6D3D1;border-bottom:1px solid #D6D3D1;vertical-align:top;width:25%;background:#FFFFFF;border-radius:0 0 8px 0">
<span style="white-space:nowrap"><img src="https://images.apifyusercontent.com/ObXkeVa5KUb-Wc5lL9kGTvTDSxQ0ckP4sADzYCnmG_U/rs:fill:76:76/cb:1/aHR0cHM6Ly9hcGlmeS1pbWFnZS11cGxvYWRzLXByb2QuczMudXMtZWFzdC0xLmFtYXpvbmF3cy5jb20vak5EYkZhYmJWeE1oblFOYjQtYWN0b3ItZ212QlpnZ3ltd24zc3ZVdEgtb3VJSjVoRk1GbC1pY29uLndlYnA.webp" width="20" height="20" style="vertical-align:middle;border-radius:4px"> &nbsp;<a href="https://apify.com/getascraper/mercari-sold-comps-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:13px">Sold&nbsp;Comps</a></span><br>
<span style="color:#57534E;font-size:11px">Sold prices and sell-through</span>
</td>
</tr>
</table>

**Get structured listing data from mercari.com, including USD prices, condition labels, listing status, seller ID, and shipping fees.** Built for resellers, pricing analysts, and store owners who need Mercari US datasets in bulk, without manual exports, complex proxy setups, or fragile scraper keys that break easily.

### 🔍 What does Mercari US Scraper do?

This Actor collects active and sold listings from any search query or category URL on Mercari US. Instead of relying on fragile webpage structures that break whenever the website changes its design, this scraper securely extracts real-time product information directly as the pages load.

It supports search queries with filters for pricing limits, item conditions, sort order, and listing status (active vs sold out). Scrolling and page transitions are handled automatically, and the run stops when your selected limit is reached.

<table width="100%"><tr>
<td style="padding:12px 18px;background:#FDECEA;border-left:4px solid #FF2019">
<span style="font-size:15px;color:#1C1917">&#9889; <b>Active and sold, in one run.</b> No account or login required. Pull live prices plus completed sold-price history for any keyword or category, ready to schedule for daily price monitoring.</span>
</td>
</tr></table>

### 💡 Why use Mercari US Scraper?

Mercari US is America's second-largest peer-to-peer secondhand marketplace. Resellers, dropshippers, and pricing analysts require stable access to listing and completed-sales data:

- **Sold Price Appraisal:** Extract historically sold items to evaluate what buyers actually paid. This is the single most valuable metric for identifying high-margin reselling opportunities.
- **Pricing Intelligence:** Pull competitor prices to feed your automated spreadsheets, calculating your exact profits after shipping fees.
- **Database Hydration:** Provide clean, structured secondary-market listings to your automated pipelines (like Airtable, Excel, or Google Sheets).

### 🚀 How to use Mercari US Scraper

1. **Configure input:** Open the Input tab in your Apify Console.
2. **Enter a keyword or URL:** Provide a search keyword or paste a valid `mercari.com` search URL directly.
3. **Apply status filters:** Set the status to `["on_sale"]` for active items, or `["sold_out"]` to extract completed sold price history.
4. **Select item conditions:** Optionally narrow down by conditions such as `["new"]` or `["like_new"]`.
5. **Set limits:** Specify a result cap (default: 1,000) and click Start.

### ⚙️ Input

| Field | Type | Description |
|---|---|---|
| `startUrls` | array | One or more Mercari US search, category, or listing URLs. |
| `keyword` | string | Search keyword query used if no `startUrls` are provided. |
| `sort` | string | Sort order: `relevance`, `price_asc`, `listed_time`, `price_desc`. |
| `status` | array | Listing status filter: `on_sale`, `sold_out`. Default: `["on_sale"]`. |
| `priceMin` | integer | Minimum price filter in USD. |
| `priceMax` | integer | Maximum price filter in USD. |
| `condition` | array | Condition labels: `new`, `like_new`, `good`, `fair`, `poor`. |
| `limit` | integer | Max listings to extract per query. Default: 25. |
| `proxyConfiguration` | object | Proxy settings. US rotating residential proxies are recommended. |

### 📦 Output

Each listing is returned as a structured JSON record inside the Apify dataset. You can download the dataset in JSON, CSV, Excel, or HTML format.

Example output record:

```json
{
  "type": "listing",
  "id": 0,
  "url": "https://www.mercari.com/us/item/m78912345678/",
  "listing_id": "m78912345678",
  "title": "Vintage Patagonian Fleece Jacket Size L",
  "description": "Retro fleece jacket in excellent shape, no stains.",
  "price": 45,
  "original_price": 120,
  "currency": "USD",
  "listing_status": "active",
  "condition_id": "like_new",
  "brand": "Patagonia",
  "size": "L",
  "color": "Blue",
  "category_path": ["Men", "Coats & jackets", "Fleece Jacket"],
  "authenticated": false,
  "likes_count": 14,
  "thumbnail_url": "https://images.mercdn.net/item/m78912345678_1.jpg",
  "media": {
    "image_urls": ["https://images.mercdn.net/item/m78912345678_1.jpg"]
  },
  "seller_id": "89123456",
  "seller_username": "retro_finds_us",
  "seller_rating_score": 4.9,
  "seller_review_count": 112,
  "sales_count": 94,
  "shipping_payer": "buyer",
  "shipping_fee": 7.99,
  "item_location": "OR",
  "scrape_context": {
    "scraped_time": 1777464674689
  }
}
```

### 📊 Data table

| Field | Description |
|---|---|
| `type` | Always `listing`. |
| `url` | Full listing URL on `mercari.com`. |
| `listing_id` | Mercari US item ID (e.g. `m78912345678`). |
| `title` | Listing title. |
| `description` | Product text description. |
| `price` | Price in USD (float). |
| `original_price` | Retail price in USD (if available). |
| `currency` | Always `USD`. |
| `listing_status` | Status code: `active` or `sold`. |
| `condition_id` | Condition rating: `new`, `like_new`, `good`, `fair`, `poor`. |
| `brand` | Product brand name. |
| `size` | Sizing information (e.g. `XL`, `8.5`). |
| `color` | Primary item color. |
| `category_path` | Array of strings representing category hierarchy. |
| `authenticated` | True if verified by Mercari Authenticate. |
| `likes_count` | Number of buyer favorites. |
| `thumbnail_url` | CDN-hosted primary image URL. |
| `media.image_urls` | List of all item photo URLs. |
| `seller_id` | Unique seller account identifier. |
| `seller_username` | Seller handle. |
| `seller_rating_score` | Average seller score out of 5 stars. |
| `seller_review_count` | Total reviews count. |
| `sales_count` | Total seller transactions. |
| `shipping_payer` | Who pays shipping: `seller` or `buyer`. |
| `shipping_fee` | Shipping rate in USD. |
| `item_location` | Sourcing state or city origin. |

### 💰 Pricing

Running this Actor costs approximately $2.99 per 1,000 results. A run of 500 listings typically completes in 2 to 3 minutes.

### ⭐ Enjoying Mercari US Scraper: Sold Prices, Conditions & Sellers?

<table width="100%">
<tr>
<td style="padding:20px 24px 14px;background:#FDEEE8;border:1px solid #F6CDBB;border-left:5px solid #E8390D;border-radius:10px 10px 0 0">
<span style="font-size:20px;letter-spacing:4px">⭐ ⭐ ⭐ ⭐ ⭐</span><br>
<span style="font-size:17px;font-weight:800;color:#1C1917">Turning Mercari US listings into sold-price data that actually helps you price your next flip?</span><br>
<span style="font-size:14px;color:#57534E">A 5-star rating takes 10 seconds and helps other resellers and pricing analysts find it. Your feedback also tells us what to build next.</span>
</td>
</tr>
<tr>
<td style="padding:0;background:#E8390D;border:1px solid #F6CDBB;border-top:none;border-radius:0 0 10px 10px;text-align:center">
<a href="https://apify.com/getascraper/mercari-us-scraper/reviews" style="display:block;padding:13px 16px;color:#FFFFFF;text-decoration:none;font-weight:800;font-size:15px;letter-spacing:0.3px">★&nbsp;&nbsp;Rate this Actor on Apify</a>
</td>
</tr>
</table>

### ✨ Tips

- **Use proxies in production:** Enable rotating proxies. Mercari US blocks search requests in large batches without rotating IP addresses.
- **Validate first:** Set the `limit` to 20-50 to check field coverage before running larger datasets.
- **Deduplication:** Adding multiple category URLs to `startUrls` will automatically deduplicate identical listing IDs inside the same run session.

### ❓ FAQ, disclaimers, and support

**Can I scrape completed sold price history?** Yes. Set the `status` field to `["sold_out"]` in the inputs.

**How does this differ from other Mercari scrapers?** Other scrapers rely on complex technical coding keys that break whenever the website's layout changes. This Actor reads the data directly as the browser receives it, making it much more reliable and stable.

**Is this compliant?** This Actor extracts public listings from `mercari.com` for research and comparison purposes. Users are responsible for ensuring their use complies with local laws, regulations, and platform terms of service.

**Support:** Open an issue in the Actor's Issues tab in your Apify Console.

### 🔗 Other actors

- [Mercari Japan Scraper: Price, Condition & Seller](https://apify.com/getascraper/mercari-japan-scraper) ↗ - collects listings, prices, and conditions from Mercari Japan.
- [Mercari Seller Scraper: Shop Listings, Ratings & Item History](https://apify.com/getascraper/mercari-seller-scraper) ↗ - pulls a Mercari seller's full shop profile and listing history.
- [Mercari Sold Comps Scraper: Sold Prices, Sell-Through & Days to Sell](https://apify.com/getascraper/mercari-sold-comps-scraper) ↗ - extracts sold-price comps and sell-through data from Mercari.
- [ThriftBooks Scraper: Cheap books, conditions, pricing and inventory specs](https://apify.com/getascraper/thriftbooks-scraper) ↗ - scrapes used book listings, conditions, and prices from ThriftBooks.
- [Whatnot Scraper: Live Shows, Products & Sellers](https://apify.com/getascraper/whatnot-scraper) ↗ - collects live shows, products, and seller data from Whatnot.

# Actor input Schema

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

Paste one or more Mercari US web links (search pages, categories, or individual items) to scrape directly.

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

Optional search term (like 'apple watch' or 'vintage leather jacket') used if you do not paste any Start URLs above.

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

Choose how to sort the search results.

## `status` (type: `array`):

Filter by item availability. Select 'on\_sale' to find active items, or 'sold\_out' to check historically sold prices.

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

Optional minimum price in US Dollars. Filters out cheaper items.

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

Optional maximum price in US Dollars. Caps search results.

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

Optional item condition filters (e.g. 'new', 'like\_new', 'good', 'fair', 'poor').

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

Maximum number of listings to save on this run. The 25-listing default amortizes browser startup cost; increase it for larger pulls.

## `proxyConfiguration` (type: `object`):

Proxy servers used to reach Mercari US. US residential proxies are required: Mercari is geoblocked outside the US and challenges datacenter IPs. Leave the default unless you have your own US proxies.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.mercari.com/search/?keyword=apple%20watch"
    }
  ],
  "sort": "relevance",
  "status": [
    "on_sale"
  ],
  "condition": [],
  "limit": 25,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrls": [
        {
            "url": "https://www.mercari.com/search/?keyword=apple%20watch"
        }
    ],
    "status": [
        "on_sale"
    ],
    "condition": [],
    "limit": 25,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "US"
    }
};

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

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

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

```

## Python example

```python
from apify_client import ApifyClient

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

# Prepare the Actor input
run_input = {
    "startUrls": [{ "url": "https://www.mercari.com/search/?keyword=apple%20watch" }],
    "status": ["on_sale"],
    "condition": [],
    "limit": 25,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "US",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("getascraper/mercari-us-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 '{
  "startUrls": [
    {
      "url": "https://www.mercari.com/search/?keyword=apple%20watch"
    }
  ],
  "status": [
    "on_sale"
  ],
  "condition": [],
  "limit": 25,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}' |
apify call getascraper/mercari-us-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,getascraper/mercari-us-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/gmvBZggymwn3svUtH/builds/qEYdemc3Jora7YHUD/openapi.json