Export public Mercari Japan search results for resale sourcing, sold-price comparison, and availability monitoring. Get structured listing identity, JPY price, observed sold status, condition, brand, public seller summary, images, query provenance, and observation time.
At a glance
- Search one or more Japanese or English keywords on
jp.mercari.com. - Filter available or sold public listings.
- Sort by relevance, newest listing, or price.
- Bound spend and output with
maxItems. - Export results as JSON, CSV, Excel, XML, or through the API.
- Receive an explicit summary for valid zero-match searches.
Who is it for?
- Resellers comparing asking prices and sold observations.
- Cross-border sourcing teams building repeatable product shortlists.
- Second-hand market analysts measuring availability and price ranges.
- Collectors monitoring trading cards, consoles, fashion, and other categories.
- Data teams feeding public marketplace observations into dashboards or databases.
Buyer workflows and use cases
- Export current listings for a sourcing spreadsheet.
- Compare sold observations before setting a resale price.
- Schedule a recurring availability monitor for a product category.
- Collect stable listing IDs for change detection.
- Compare conditions and public seller IDs across similar listings.
The Actor never signs in or collects messages, purchases, offers, private profiles, cookies, or authenticated seller data.
Ready-to-run tasks
Use these editable Examples recipes for distinct buyer workflows:
Export source gaming consoles
{
"searchQueries": ["Nintendo Switch"],
"maxItems": 100
}
Compare sold trading card prices
{
"searchQueries": ["ポケモンカード"],
"status": "sold",
"maxItems": 100
}
Monitor luxury handbag listings
{
"searchQueries": ["ルイヴィトン バッグ"],
"status": "available",
"maxItems": 100
}
Input example
{
"searchQueries": ["Nintendo Switch", "ポケモンカード"],
"status": "sold",
"sortBy": "newest",
"sortOrder": "desc",
"maxItems": 100
}
Output example
{
"id": "m58902716035",
"url": "https://jp.mercari.com/item/m58902716035",
"title": "Nintendo Switch console",
"price": 24500,
"currency": "JPY",
"status": "available",
"isSold": false,
"condition": "目立った傷や汚れなし",
"seller": {"id": "399804015"},
"imageUrls": ["https://static.mercdn.net/thumb/item/webp/example.jpg"],
"searchQuery": "Nintendo Switch",
"scrapedAt": "2026-09-25T00:00:00.000Z"
}
API usage
Node.js
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('fetch_cat/mercari-japan-search-scraper').call({
searchQueries: ['Nintendo Switch'],
maxItems: 20,
});
console.log(run.defaultDatasetId);
Python
from apify_client import ApifyClient
client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("fetch_cat/mercari-japan-search-scraper").call(run_input={
"searchQueries": ["Nintendo Switch"],
"maxItems": 20,
})
print(run["defaultDatasetId"])
cURL
curl -X POST \
"https://api.apify.com/v2/acts/fetch_cat~mercari-japan-search-scraper/runs?token=YOUR_APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"searchQueries":["Nintendo Switch"],"maxItems":20}'
MCP and AI agents
Use the Actor through the official Apify MCP Server:
claude mcp add --transport http apify \
"https://mcp.apify.com?tools=fetch_cat/mercari-japan-search-scraper"
Or add the server to an MCP client configuration:
{
"mcpServers": {
"apify": {
"url": "https://mcp.apify.com?tools=fetch_cat/mercari-japan-search-scraper"
}
}
}
Example prompt: “Export 20 available Nintendo Switch listings from Mercari Japan and summarize the price range.”
Scheduling and integrations
Schedule repeat runs in Apify Console to monitor inventory. Send completed datasets to Google Sheets, webhooks, cloud storage, or your own API. Compare stable id, price, and status fields between runs to detect changes.
Limits and caveats
- Mercari may change its public web application, JSON fields, rate limits, or geo behavior.
- A listing can change or disappear after it is collected.
- Sold status is an observation, not a historical transaction record.
- Category, brand, and seller summary fields are included only when the public search response supplies them.
- This product targets Mercari Japan, not Mercari US.
- It does not send messages, make offers, or purchase products.
Support
Open an issue from the Actor page if a run fails or output looks wrong. Include the run ID, redacted input, expected behavior, actual behavior, and one reproducible public listing or search URL. Never include account credentials, cookies, messages, or purchase data.
