# Mercari Listing Scraper

> Mercari Listing Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Scrapes and returns structured product listing data from Mercari US, including prices, titles, statuses, and optional item details.

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/mercari?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mercari-listing-scraper-ed081b0a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_iZ_eKD274HjFukjfupwIr

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability mercari-listing-scraper-ed081b0a -d '<json body>'
```

Example prompt: Search Mercari for 'Nintendo Switch OLED' listings that are currently on sale, priced between $200 and $350, sorted by lowest price first, and return up to 50 results with full item details including descriptions and photos.

## When to prefer this

Choose this endpoint when you need structured, machine-readable Mercari listing data at scale — especially for price research, resale valuation, inventory monitoring, or competitive analysis on the US Mercari marketplace. It is pay-per-successful-call, making it cost-safe for exploratory queries. Prefer it over generic web scrapers when you need Mercari-specific filtering by price, status, and sort order with a clean JSON schema.

## Known failure modes

- Empty result set if keyword or URL yields no matching listings (not charged)
- Invalid or non-US Mercari URL causes failed run (not charged)
- Rate limiting or anti-scrape measures on Mercari's side may cause partial results
- priceMin greater than priceMax returns no results
- Unsupported URL type (e.g. non-US Mercari domain) may fail silently

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

Returns a JSON object with a count of listings found, the product source identifier ('mercari'), and an array of items each containing listing ID, URL, type, title, price in dollars, price in cents, and optionally full description when includeDetails is enabled.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sort": {
   "enum": [
    "relevance",
    "newest",
    "price_low",
    "price_high",
    "recently_sold"
   ],
   "type": "string",
   "default": "relevance",
   "description": "Result order requested from Mercari for category and brand pages."
  },
  "limit": {
   "type": "integer",
   "default": 100,
   "minimum": 1,
   "description": "Maximum number of unique listings in the entire run."
  },
  "status": {
   "type": "array",
   "items": {
    "enum": [
     "on_sale",
     "sold_out",
     "trading"
    ],
    "type": "string",
    "enumTitles": [
     "On sale",
     "Sold out",
     "Trading"
    ]
   },
   "default": [],
   "description": "Include only these listing states. Empty includes all states."
  },
  "keyword": {
   "type": "string",
   "description": "Search phrase. If URLs are provided, this overrides their keyword. Without URLs, searches the top-level US categories."
  },
  "priceMax": {
   "type": "number",
   "minimum": 0,
   "description": "Maximum listed price in US dollars, inclusive."
  },
  "priceMin": {
   "type": "number",
   "minimum": 0,
   "description": "Minimum listed price in US dollars, inclusive."
  },
  "startUrls": {
   "type": "array",
   "description": "US Mercari category, brand, shop, search, or item URLs. Search URLs are expanded across top-level categories."
  },
  "includeDetails": {
   "type": "boolean",
   "default": false,
   "description": "Open each item page for description, full photo set, condition, shipping details, and timestamps. Increases requests and cost."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "id": null,
    "url": null,
    "type": null,
    "price": null,
    "title": null,
    "listingId": null,
    "priceCents": null,
    "description": null
   }
  ],
  "product": "mercari"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mercari-listing-scraper-ed081b0a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)