# Mercari Scraper - US Listings, Prices & Resale Data (`quine/mercari-scraper`) Actor

Scrape Mercari US listings and prices - search by keyword. Structured JSON with price, brand, size, condition and images. Runs with defaults, MCP-ready.

- **URL**: https://apify.com/quine/mercari-scraper.md
- **Developed by:** [Quine Quine](https://apify.com/quine) (community)
- **Categories:** E-commerce
- **Stats:** 2 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.50 / 1,000 listing-scrapeds

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
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 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 Scraper: US Listings, Prices & Resale Data

Scrape **Mercari US listings and prices** in one run.
Built for resellers, price comparison, and market research: fast, reliable, and
returned as clean structured JSON. Runs with defaults and works as an **MCP tool**
for AI agents.

### What it does

Give it a search term (or leave it empty for the newest listings) and it scrapes
Mercari's US marketplace. Every listing comes back as a structured record you can
build on:

- **US resale price data** at scale on one of the largest US consumer second-hand markets
- Search by keyword or pull the newest listings
- **Discount signal**: surfaces the real was-price on marked-down items (~46% of listings carry a discount)
- Reliable through Mercari's Cloudflare anti-bot protection
- **Stable JSON schema**: safe to depend on in code and pipelines
- **Runs with defaults** and **MCP-ready**: AI agents can discover and call it as a tool

### Input

| Field | Type | Default | Description |
|---|---|---|---|
| `query` | string | `""` | Search term. Empty = newest listings. |
| `countries` | array | `["us"]` | Marketplace region. Mercari runs on US / USD. |
| `maxItems` | integer | `100` | Max listings returned. |
| `filters` | object | `{}` | Optional filters: `category`, `brand`, `condition`, `price_min`, `price_max`. |
| `proxyConfiguration` | object | required | US residential proxy. Mercari is Cloudflare-gated, so a US residential proxy is required. |

**Example input**

```json
{
  "query": "nike",
  "maxItems": 100,
  "filters": {}
}
```

### Output

Each item is one dataset record:

```json
{
  "id": "m12345678901",
  "url": "https://www.mercari.com/us/item/m12345678901/",
  "title": "Nike hoodie",
  "price": { "amount": 20.9, "currency": "USD" },
  "originalPrice": { "amount": 35.0, "currency": "USD" },
  "brand": "Nike",
  "size": "M",
  "condition": "Good",
  "category": "Athletic",
  "country": "us",
  "images": ["https://static.mercdn.net/item/detail/orig/photos/....jpg"],
  "listedAt": "2026-06-22T00:00:00+00:00",
  "isPromoted": true,
  "status": "on_sale",
  "scrapedAt": "2026-07-10T12:00:00+00:00"
}
```

Optional fields (like `originalPrice`) appear only when present on the listing.

- `originalPrice` appears only on marked-down items: a real was-price. Roughly 46% of listings carry a discount.
- `status` is availability: `on_sale` or `trading`.
- `isPromoted` flags seller-boosted listings.
- `listedAt` is derived from the primary photo timestamp, so it is an approximate list time.

### Use cases

- **Reseller sourcing**: find underpriced and discounted listings to flip
- **Price monitoring**: track prices for brands, categories, or conditions over time
- **Market research**: supply, pricing, and brand trends on a major US resale marketplace
- **AI agents**: a reliable data tool an agent can call to answer "what does X sell for on Mercari?"

### Pricing

**Pay per result**: you are charged per listing returned, so you only pay for data
you actually get. See the exact per-event price on this Actor's page.

### Fair use & privacy

Reads **public listings only**: no login and no buyer or seller account cookies.
Personal seller profiles are **not** collected: the output contains listing data,
not people.

# Actor input Schema

## `query` (type: `string`):

What to search for. For most marketplaces this is a keyword; for the real-estate scraper it is a location slug (e.g. madrid-madrid). Leave empty to get the newest listings. See the README.

## `countries` (type: `array`):

Marketplace region(s). Single-region sites ignore this and always return their home market; multi-region sites use it to pick the locale/currency. See the README for what this target supports.

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

Hard cap on the number of listings returned.

## `filters` (type: `object`):

Optional marketplace-specific filters (e.g. price range, category, condition, sort). See this actor's README for the supported keys.

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

Residential proxy is recommended, and REQUIRED for the anti-bot-protected marketplaces (DataDome / Cloudflare block datacenter IPs). Use Apify Residential (paid plans) or plug in your own residential proxy URLs.

## Actor input object example

```json
{
  "query": "",
  "countries": [
    "fr"
  ],
  "maxItems": 100,
  "filters": {},
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `listings` (type: `string`):

All scraped listings as structured records (price, category, condition, location, images, URL and more, depending on the marketplace).

# 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 = {
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

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

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

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

```

## Python example

```python
from apify_client import ApifyClient

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

# Prepare the Actor input
run_input = { "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    } }

# Run the Actor and wait for it to finish
run = client.actor("quine/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 '{
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call quine/mercari-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=quine/mercari-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/puHGamT7H2l2qIu8x/builds/u4LdEgtdAYAV4wEgG/openapi.json