Mercari Japan Search Data — Keyword, Category, Status & Price
Send a keyword and this source searches Mercari in Japan and returns matching items as data: ID, URL, name, price in JPY, status, thumbnail and photo.
{
"session_id": "11111111-1111-1111-1111-111111111111",
"kind": "mercari_items_search",
"keyword": "iphone 15",
"max_items": 2,
"start_page": 1,
"partial": false,
"human": "# Mercari items search\n\n- **Keyword:** iphone 15\n- **Max items:** 2\n- **Starting page:** 1\n- **Records returned:** 2\n- **Proxy traffic:** 533.2 KB",
"machine": {
"total_items": 2,
"items": [
{
"@type": "MercariSearchItem",
"id": "m53977554531",
"url": "https://jp.mercari.com/item/m53977554531",
"name": "iPhone 15 Pro 128GB｜SIMフリー",
"price": 78000,
"currency": "JPY",
"status": "on_sale",
"photo": "https://static.mercdn.net/item/detail/orig/photos/m53977554531_1.jpg?1790778955",
"thumbnail": "https://static.mercdn.net/thumb/item/webp/m53977554531_1.jpg?1790778955",
"item_type": "item",
"page": 1,
"position": 1
},
{
"@type": "MercariSearchItem",
"id": "m31273954054",
"url": "https://jp.mercari.com/item/m31273954054",
"name": "極美品 iPhone 15 128GB ブルー 本体",
"price": 70000,
"currency": "JPY",
"status": "on_sale",
"photo": "https://static.mercdn.net/item/detail/orig/photos/m31273954054_1.jpg?1790779613",
"thumbnail": "https://static.mercdn.net/thumb/item/webp/m31273954054_1.jpg?1790779613",
"item_type": "item",
"page": 1,
"position": 2
}
],
"response_bytes": 545990
},
"total_points": 2
}- You send
- A search keyword, with optional category, sort, status and price filters
- You get back
- Matching items with ID, URL, name, price (JPY), status, thumbnail and photo
- Coverage
- Mercari Japan items that appear in Mercari search results.
- Price
- 1 point per returned result, up to 500 per request — $1 per 1,000
- Billed per record actually returned, capped by max_items. A search that matches nothing costs nothing.
Ways to get this data
Three approaches teams use today, and where each one runs into trouble.
| Approach | What it takes | Cost | Trade-off |
|---|---|---|---|
| Searching Mercari by hand | Set filters in the browser, scroll, copy results | Free, and slow | Nobody keeps a market snapshot current this way |
| Building a scraper | Write it, host it, and repair it when Mercari changes the results page | Engineering time | A maintenance commitment for something that isn't your product |
| NeuralVerge | One request, filters as parameters | $1 per 1,000, misses not billed | A broad keyword with no filters returns a lot of noise before you tune it |
What you get back
Every field in the response shown above.
| Field | Type | Description |
|---|---|---|
total_items | number | How many items were returned in this batch (capped by max_items). |
id | string | Mercari item ID. |
url | string | Direct link to the item. |
name | string | Item title. |
price | number | Price. |
currency | string | Currency code, e.g. JPY. |
status | string | Item status, e.g. on_sale. |
photo | string | Full-size photo URL. |
thumbnail | string | Thumbnail URL. |
item_type | string | Type of result, e.g. item. |
page | number | Results page the item appeared on. |
position | number | Position of the item in the results. |
How to run it
The same lookup works from the app, the API, or as a tool an agent can call mid-task.
keyword is the only required field. max_items caps the result count (up to 500) and sets what you're billed for. sort (score, created_time, price, num_likes), order (desc or asc), status, category_id, price_min and price_max narrow the query before you pay for results.
curl -X POST https://api.neuralverge.ai/functions/v1/run-mercari-items-search \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "keyword": "iphone 15", "max_items": 2 }'What teams use it for
Where this field shows up in an actual workflow.
Pull current prices for a product type and compare them.
Use the status filter to separate items on sale from sold ones.
Sort by most liked or newest to see what is drawing attention.
Find item IDs to feed into Mercari item for full detail.
Coverage, freshness and limits
What this source covers, how fresh it is, and where it stops.
Mercari Japan items that appear in Mercari search results.
Searched at request time.
This source returns publicly visible search results, stamped with the keyword it was read from and a session id you can trace.
- —Result order follows Mercari's own ranking for the sort you choose.
- —Search results carry less detail than a full item; run Mercari item for description, condition, shipping and seller.
- —A broad keyword returns a broad result set — narrow it or you'll pay for noise.
Questions, answered
category_id, status, price_min and price_max in JPY, plus sort (score, created_time, price or num_likes) and order (desc or asc).
Related sources
Try mercari items search on your own data
One request format across every source in the catalog.