Mercari Japan Listings by Condition, Price & Status
Search Mercari Japan by keyword and filter by item condition, listing status, and price range in JPY, with seller, category, images, and listing URL for each match.
Input schema
Input fields, types, required flags, descriptions, defaults, and prefills come from the published definition. Prefill examples are distinct from defaults.
| Field | Type | Required | Description |
|---|---|---|---|
mode | string | optional | How to find listings. |
keyword | string | optional | Search term, in Japanese or English (mode=search). |
startUrls | array | optional | Search, item or shop links to scrape (mode=byUrl). Mixing link types is fine. |
Show all input fields
| Field | Type | Required | Description |
|---|---|---|---|
mode | string | optional | How to find listings. |
keyword | string | optional | Search term, in Japanese or English (mode=search). |
startUrls | array | optional | Search, item or shop links to scrape (mode=byUrl). Mixing link types is fine. |
shop | string | optional | Shop ID, storefront URL or shop product URL (mode=shop). |
status | string | optional | On sale, exact sold out, trading, sold (sold out plus trading, the site's sold filter), or all. |
condition | string | optional | Filter by Mercari's six condition grades. |
sortBy | string | optional | Result order. |
category | string | optional | Category name, path or numeric ID, e.g. `ゲーム・おもちゃ・グッズ > テレビゲーム` or `7002`. |
brand | string | optional | Brand name (Japanese or English) or numeric ID, e.g. `Nintendo`, `任天堂` or `15487`. |
size | string | optional | Mercari size filter. The group name is shown before each size. |
sellerType | string | optional | Individual sellers, Mercari Shops, or both. |
excludeKeyword | string | optional | Drop listings whose title contains this word. Applied by Mercari's search. |
minPrice | integer | optional | Lowest price in Japanese yen. |
maxPrice | integer | optional | Highest price in Japanese yen. |
maxItems | integer | optional | Maximum listings to save. |
includeDetails | boolean | optional | Open each listing for its description, all photos, seller rating, likes and shipping details. |
Download the published input schema
View complete JSON
{
"description": "Search Mercari Japan listings by keyword or URL, with condition, price, status, category, brand, size and seller filters.",
"properties": {
"brand": {
"description": "Brand name (Japanese or English) or numeric ID, e.g. `Nintendo`, `任天堂` or `15487`.",
"editor": "textfield",
"title": "Brand",
"type": "string"
},
"category": {
"description": "Category name, path or numeric ID, e.g. `ゲーム・おもちゃ・グッズ > テレビゲーム` or `7002`.",
"editor": "textfield",
"title": "Category",
"type": "string"
},
"condition": {
"default": "any",
"description": "Filter by Mercari's six condition grades.",
"editor": "select",
"enumSuggestedValues": [
"any",
"1",
"2",
"3",
"4",
"5",
"6"
],
"enumTitles": [
"Any condition",
"New",
"Like New",
"Good",
"Fair",
"Poor",
"Very Poor"
],
"prefill": "any",
"title": "Item condition",
"type": "string"
},
"excludeKeyword": {
"description": "Drop listings whose title contains this word. Applied by Mercari's search.",
"editor": "textfield",
"title": "Exclude keyword",
"type": "string"
},
"includeDetails": {
"default": true,
"description": "Open each listing for its description, all photos, seller rating, likes and shipping details.",
"prefill": true,
"title": "Include item details",
"type": "boolean"
},
"keyword": {
"description": "Search term, in Japanese or English (mode=search).",
"editor": "textfield",
"prefill": "Nintendo Switch",
"title": "Keyword",
"type": "string"
},
"maxItems": {
"default": 100,
"description": "Maximum listings to save.",
"maximum": 2000,
"minimum": 1,
"prefill": 3,
"title": "Max items",
"type": "integer"
},
"maxPrice": {
"description": "Highest price in Japanese yen.",
"maximum": 1000000000,
"minimum": 0,
"title": "Maximum price (JPY)",
"type": "integer"
},
"minPrice": {
"description": "Lowest price in Japanese yen.",
"maximum": 1000000000,
"minimum": 0,
"title": "Minimum price (JPY)",
"type": "integer"
},
"mode": {
"default": "search",
"description": "How to find listings.",
"editor": "select",
"enum": [
"search",
"byUrl",
"shop"
],
"enumTitles": [
"Search by keyword",
"Paste Mercari URLs",
"Mercari Shops storefront"
],
"prefill": "search",
"title": "Mode",
"type": "string"
},
"sellerType": {
"default": "any",
"description": "Individual sellers, Mercari Shops, or both.",
"editor": "select",
"enum": [
"any",
"individual",
"shop"
],
"enumTitles": [
"Any seller",
"Individual sellers",
"Mercari Shops"
],
"prefill": "any",
"title": "Seller type",
"type": "string"
},
"shop": {
"description": "Shop ID, storefront URL or shop product URL (mode=shop).",
"editor": "textfield",
"title": "Mercari Shops ID or URL",
"type": "string"
},
"size": {
"default": "any",
"description": "Mercari size filter. The group name is shown before each size.",
"editor": "select",
"enum": [
"any",
"153",
"154",
"2",
"3",
"4",
"5",
"155",
"156",
"157",
"7",
"133",
"134",
"135",
"136",
"137",
"9",
"10",
"11",
"12",
"13",
"138",
"139",
"140",
"141",
"142",
"143",
"144",
"145",
"146",
"147",
"148",
"16",
"17",
"18",
"19",
"20",
"21",
"22",
"149",
"150",
"151",
"152",
"34",
"35",
"36",
"37",
"38",
"40",
"41",
"42",
"43",
"44",
"45",
"55",
"47",
"48",
"49",
"50",
"51",
"52",
"53",
"54",
"56",
"57",
"58",
"59",
"60",
"90",
"91",
"92",
"93",
"94",
"95",
"96",
"97",
"98",
"99",
"114",
"115",
"116",
"117",
"118",
"119",
"120",
"121",
"122",
"123",
"124",
"125",
"76",
"77",
"78",
"79",
"80",
"81",
"82",
"83",
"84",
"85",
"86",
"87",
"88",
"89",
"158",
"67",
"68",
"69",
"70",
"71",
"72",
"73",
"74",
"75",
"159",
"160",
"161",
"126",
"127",
"128",
"129",
"130",
"131",
"132",
"100",
"101",
"102",
"103",
"104",
"105",
"106"
],
"enumTitles": [
"Any size",
"洋服のサイズ – XXS以下",
"洋服のサイズ – XS(SS)",
"洋服のサイズ – S",
"洋服のサイズ – M",
"洋服のサイズ – L",
"洋服のサイズ – XL(LL)",
"洋服のサイズ – 2XL(3L)",
"洋服のサイズ – 3XL(4L)",
"洋服のサイズ – 4XL(5L)以上",
"洋服のサイズ – FREE SIZE",
"メンズ靴のサイズ – 23.5cm以下",
"メンズ靴のサイズ – 24cm",
"メンズ靴のサイズ – 24.5cm",
"メンズ靴のサイズ – 25cm",
"メンズ靴のサイズ – 25.5cm",
"メンズ靴のサイズ – 26cm",
"メンズ靴のサイズ – 26.5cm",
"メンズ靴のサイズ – 27cm",
"メンズ靴のサイズ – 27.5cm",
"メンズ靴のサイズ – 28cm",
"メンズ靴のサイズ – 28.5cm",
"メンズ靴のサイズ – 29cm",
"メンズ靴のサイズ – 29.5cm",
"メンズ靴のサイズ – 30cm",
"メンズ靴のサイズ – 30.5cm",
"メンズ靴のサイズ – 31cm以上",
"レディース靴のサイズ – 20cm以下",
"レディース靴のサイズ – 20.5cm",
"レディース靴のサイズ – 21cm",
"レディース靴のサイズ – 21.5cm",
"レディース靴のサイズ – 22cm",
"レディース靴のサイズ – 22.5cm",
"レディース靴のサイズ – 23cm",
"レディース靴のサイズ – 23.5cm",
"レディース靴のサイズ – 24cm",
"レディース靴のサイズ – 24.5cm",
"レディース靴のサイズ – 25cm",
"レディース靴のサイズ – 25.5cm",
"レディース靴のサイズ – 26cm",
"レディース靴のサイズ – 26.5cm",
"レディース靴のサイズ – 27cm",
"レディース靴のサイズ – 27.5cm以上",
"スカートのサイズ – 60cm以下",
"スカートのサイズ – ~70cm",
"スカートのサイズ – ~80cm",
"スカートのサイズ – ~90cm",
"スカートのサイズ – 90cm以上",
"キッズ服のサイズ – 100cm",
"キッズ服のサイズ – 110cm",
"キッズ服のサイズ – 120cm",
"キッズ服のサイズ – 130cm",
"キッズ服のサイズ – 140cm",
"キッズ服のサイズ – 150cm",
"キッズ服のサイズ – 160cm",
"ベビー・キッズ靴のサイズ – 10.5cm以下",
"ベビー・キッズ靴のサイズ – 11cm・11.5cm",
"ベビー・キッズ靴のサイズ – 12cm・12.5cm",
"ベビー・キッズ靴のサイズ – 13cm・13.5cm",
"ベビー・キッズ靴のサイズ – 14cm・14.5cm",
"ベビー・キッズ靴のサイズ – 15cm・15.5cm",
"ベビー・キッズ靴のサイズ – 16cm・16.5cm",
"ベビー・キッズ靴のサイズ – 17cm以上",
"ベビー服のサイズ – 60cm",
"ベビー服のサイズ – 70cm",
"ベビー服のサイズ – 80cm",
"ベビー服のサイズ – 90cm",
"ベビー服のサイズ – 95cm",
"テレビのサイズ – ~20インチ",
"テレビのサイズ – 20~26インチ",
"テレビのサイズ – 26~32インチ",
"テレビのサイズ – 32~37インチ",
"テレビのサイズ – 37~40インチ",
"テレビのサイズ – 40~42インチ",
"テレビのサイズ – 42~46インチ",
"テレビのサイズ – 46~52インチ",
"テレビのサイズ – 52~60インチ",
"テレビのサイズ – 60インチ~",
"カメラレンズのサイズ – ニコンFマウント",
"カメラレンズのサイズ – キヤノンEFマウント",
"カメラレンズのサイズ – ペンタックスKマウント",
"カメラレンズのサイズ – ペンタックスQマウント",
"カメラレンズのサイズ – フォーサーズマウント",
"カメラレンズのサイズ – マイクロフォーサーズマウント",
"カメラレンズのサイズ – α Aマウント",
"カメラレンズのサイズ – α Eマウント",
"カメラレンズのサイズ – ニコン1マウント",
"カメラレンズのサイズ – キヤノンEF-Mマウント",
"カメラレンズのサイズ – Xマウント",
"カメラレンズのサイズ – シグマSAマウント",
"オートバイのサイズ – 50cc以下",
"オートバイのサイズ – 51cc-125cc",
"オートバイのサイズ – 126cc-250cc",
"オートバイのサイズ – 251cc-400cc",
"オートバイのサイズ – 401cc-750cc",
"オートバイのサイズ – 751cc以上",
"ヘルメットのサイズ – XSサイズ以下",
"ヘルメットのサイズ – Sサイズ",
"ヘルメットのサイズ – Mサイズ",
"ヘルメットのサイズ – Lサイズ",
"ヘルメットのサイズ – XLサイズ",
"ヘルメットのサイズ – XXLサイズ以上",
"ヘルメットのサイズ – フリーサイズ",
"ヘルメットのサイズ – 子ども用",
"タイヤのサイズ – 12インチ",
"タイヤのサイズ – 13インチ",
"タイヤのサイズ – 14インチ",
"タイヤのサイズ – 15インチ",
"タイヤのサイズ – 16インチ",
"タイヤのサイズ – 17インチ",
"タイヤのサイズ – 18インチ",
"タイヤのサイズ – 19インチ",
"タイヤのサイズ – 20インチ",
"タイヤのサイズ – 21インチ",
"タイヤのサイズ – 22インチ",
"タイヤのサイズ – 23インチ",
"タイヤのサイズ – 24インチ",
"スキーのサイズ – 140cm~",
"スキーのサイズ – 150cm~",
"スキーのサイズ – 160cm~",
"スキーのサイズ – 170cm~",
"スキーのサイズ – スキーボード",
"スキーのサイズ – 子ども用",
"スキーのサイズ – その他",
"スノーボードのサイズ – 135cm-140cm未満",
"スノーボードのサイズ – 140cm-145cm未満",
"スノーボードのサイズ – 145cm-150cm未満",
"スノーボードのサイズ – 150cm-155cm未満",
"スノーボードのサイズ – 155cm-160cm未満",
"スノーボードのサイズ – 160cm-165cm未満",
"スノーボードのサイズ – 165cm-170cm未満"
],
"prefill": "any",
"title": "Size",
"type": "string"
},
"sortBy": {
"default": "default",
"description": "Result order.",
"editor": "select",
"enum": [
"default",
"created_time",
"price_asc",
"price_desc",
"num_likes"
],
"enumTitles": [
"Relevance",
"Newest first",
"Price: low to high",
"Price: high to low",
"Most liked"
],
"prefill": "default",
"title": "Sort by",
"type": "string"
},
"startUrls": {
"description": "Search, item or shop links to scrape (mode=byUrl). Mixing link types is fine.",
"editor": "requestListSources",
"title": "Mercari URLs",
"type": "array"
},
"status": {
"default": "on_sale",
"description": "On sale, exact sold out, trading, sold (sold out plus trading, the site's sold filter), or all.",
"editor": "select",
"enumSuggestedValues": [
"on_sale",
"sold_out",
"trading",
"sold",
"all"
],
"enumTitles": [
"On sale",
"Sold out only",
"Trading",
"Sold (sold out + trading)",
"All statuses"
],
"prefill": "on_sale",
"title": "Listing status",
"type": "string"
}
},
"schemaVersion": 1,
"title": "Mercari Japan Scraper Input",
"type": "object"
}
Output schema
Published result links and storage locations. This schema is not an exhaustive contract for every field in a dataset record.
| Field | Type | Required | Description |
|---|---|---|---|
results | string | optional | Dataset containing all scraped Mercari Japan listing records. |
Download the published output schema
View complete JSON
{
"actorOutputSchemaVersion": 1,
"description": "One record per Mercari Japan listing, with price in JPY, condition, status, brand, category, description, seller rating, photos, shipping and sold/trading listings.",
"properties": {
"results": {
"description": "Dataset containing all scraped Mercari Japan listing records.",
"template": "{{links.apiDefaultDatasetUrl}}/items",
"title": "Mercari Japan listings",
"type": "string"
}
},
"title": "Mercari Japan Listings by Condition, Price & Status Output"
}
Dataset schema
Published dataset views and any declared field definitions. A view can select only a subset of the returned record fields.
Download the published dataset schema
View complete JSON
{
"actorSpecification": 1,
"views": {
"overview": {
"display": {
"component": "table",
"properties": {}
},
"title": "Items",
"transformation": {
"fields": [
"name",
"price",
"currency",
"condition",
"status",
"brandName",
"sellerRating",
"itemUrl"
]
}
}
}
}
Key-value schema
Published key-value store definitions, when provided by this build.
This definition is not present in the default published build. See the published README for available documentation.
Published README
Read the full published documentation
Mercari Japan Listings by Condition, Price & Status
Scrape Mercari Japan (jp.mercari.com) for active, sold and in-transaction listings. Search by keyword with condition, price, status, category, brand, size and seller filters, or paste search, item and Mercari Shops links. Each row carries the listing's real price in yen, condition, status, seller rating, description, photos and shipping details.
No login, cookies, API key or proxy setup is needed. Prices are in JPY; condition and status labels are in English.
What this actor does
- Keyword search with Mercari's own filters: condition (six grades), price range, status (on sale, sold out, trading, sold, all), category, brand, size, seller type and exclude keyword.
- Paste links: search result URLs keep their filters; item URLs and Mercari Shops product URLs return one detailed record each. Mix different link types in one run.
- Mercari Shops storefronts: list a shop's products with the same detail enrichment.
- Five sort orders: relevance, newest, price low to high, price high to low, most liked.
- Rich records: description, every photo, seller name and rating, likes, category path, brand, size, shipping payer/method/origin/speed and auction data when present.
- Empty fields are omitted from a record rather than filled with
nullor a placeholder.
Output per listing
| Field | Description |
|---|---|
itemId |
Mercari item ID (personal) or product ID (Mercari Shops) |
itemUrl |
Direct listing URL (/item/... or /shops/product/...) |
itemType |
personal or shop |
name |
Listing title as written by the seller |
price |
Price in Japanese yen |
currency |
Always JPY |
status |
on_sale, sold_out or trading |
condition |
English condition label: New, Like New, Good, Fair, Poor or Very Poor |
conditionId |
Mercari condition ID (1-6) |
brandName, brandId |
Brand, when the listing has one |
category, categoryId |
Leaf category name and ID (category is the numeric ID when includeDetails=false) |
categoryPath |
Full category path, e.g. ゲーム・おもちゃ・グッズ > テレビゲーム > Nintendo Switch |
sizeName, sizeId |
Size, when the listing has one |
description |
Full listing description |
imageUrl, imageUrls[] |
Main full-size photo and all photos |
thumbnailUrl |
Thumbnail image |
seller |
Seller display name |
sellerId |
Seller ID (or Mercari Shops shop ID) |
sellerRating |
Seller star rating (0-5) |
sellerRatingCount |
Number of seller ratings |
likes |
Like count; zero is a real value |
commentCount |
Comment count, when shown |
shippingPayer |
Seller or Buyer |
shippingMethod |
Shipping method, e.g. らくらくメルカリ便 |
shippingFromArea |
Prefecture the item ships from |
shippingDuration |
Dispatch window, e.g. 1~2日で発送 |
isAuction, auction |
Auction flag and bid details when the listing is an auction |
createdAt, updatedAt |
Listing timestamps in ISO 8601 UTC |
searchKeyword, sourceUrl |
Keyword or source link that produced the row |
scrapedAt |
When the row was collected |
Input
| Field | Type | Default | Description |
|---|---|---|---|
mode |
string | search |
search, byUrl or shop |
keyword |
string | – (prefill: Nintendo Switch) |
Search term (mode=search) |
startUrls |
array | – | Search, item or shop links (mode=byUrl) |
shop |
string | – | Mercari Shops ID, storefront URL or shop product URL (mode=shop) |
status |
string | on_sale |
on_sale, sold_out, trading, sold (sold out + trading) or all |
condition |
string | any |
any, or 1-6 (New … Very Poor) |
sortBy |
string | default |
default, created_time, price_asc, price_desc or num_likes |
category |
string | – | Category name, path or numeric ID |
brand |
string | – | Brand name (Japanese or English) or numeric ID |
size |
string | any |
Any of Mercari's 130 size values, grouped by size type |
sellerType |
string | any |
any, individual or shop |
excludeKeyword |
string | – | Drop titles containing this word |
minPrice |
integer | – | Minimum price in JPY |
maxPrice |
integer | – | Maximum price in JPY |
maxItems |
integer | 100 |
Maximum listings to save (1-2,000) |
includeDetails |
boolean | true |
Open each listing for description, all photos, seller rating, likes and shipping details |
Example: like-new games under ¥5,000
{
"mode": "search",
"keyword": "Nintendo Switch",
"condition": "2",
"maxPrice": 5000,
"sortBy": "price_asc",
"maxItems": 100
}
Example: sold comparables for a camera
{
"mode": "search",
"keyword": "Nikon Z6",
"status": "sold",
"sortBy": "created_time",
"maxItems": 200
}
Example: brand and size on fashion
{
"mode": "search",
"keyword": "Tシャツ",
"brand": "Nike",
"size": "3",
"condition": "3",
"maxItems": 50
}
Example: paste links
{
"mode": "byUrl",
"startUrls": [
{ "url": "https://jp.mercari.com/search?keyword=ポケモンカード&status=on_sale&price_min=1000" },
{ "url": "https://jp.mercari.com/item/m62109311441" },
{ "url": "https://jp.mercari.com/shops/product/2JXdgagXNJQg8TL7TuwiZG" }
],
"maxItems": 20
}
Example: a Mercari Shops storefront
{
"mode": "shop",
"shop": "https://jp.mercari.com/shops/profile/Bh6cspVjCR9oww4P7w7eHm",
"maxItems": 100,
"sortBy": "price_asc"
}
Use cases
- Resale sourcing — find underpriced items by condition and price band before competitors.
- Sold-price research — collect sold and in-transaction listings for a model or brand.
- Price monitoring — schedule a search and compare asking prices over time.
- Brand and size intelligence — see what a brand actually lists in each size and condition.
- Shop catalogue exports — export a Mercari Shops storefront with seller ratings and photos.
- Cross-border sourcing — use the description, photos and shipping origin to evaluate imports.
FAQ
Do I need a Mercari account, cookies or an API key?
No. The actor reads public Mercari Japan listing data without login, cookies or an API key.
Do I need to configure a proxy?
No. The actor connects directly to Mercari without a proxy. Just fill in the input and run it.
What is the difference between sold_out, trading and sold?
sold_out returns only completed sales. trading returns listings with a purchase in progress. sold combines both, which matches Mercari's own "sold out" filter on the website. When you paste a Mercari search link, its own status value is honored as the site defines it, so a link using the site's status=sold_out filter maps to sold (sold out plus trading). Use the status input for an exact sold_out filter.
Why are some fields missing from a record?
Mercari does not publish every field for every listing. For example, many listings have no brand or size. Those fields are omitted; the actor never invents values.
What does includeDetails change?
With details on, the actor opens each listing to add its full description, all photos, seller name and rating, likes, category name and path, and shipping details. Turning it off makes runs faster; category then falls back to the numeric ID and the description, seller rating, likes, category path and shipping details are omitted.
How many listings can I get per run?
Up to 2,000 per run. Mercari itself serves at most about 100 pages per search (roughly 12,000 unique listings) and reports a matching count capped at 15,000. Split a broad search by category, brand or price range to go deeper.
Does the condition filter use English or Japanese grades?
The input uses Mercari's numeric grades 1-6, shown in English as New, Like New, Good, Fair, Poor and Very Poor. Japanese titles and descriptions stay in their original language.
Can I use Japanese keywords and brand names?
Yes. Keywords, category names and brand names accept Japanese and English. Brand and category names are resolved to Mercari's own IDs automatically.
Are Mercari Shops listings included?
Yes. Search results include both individual and shop listings unless you choose sellerType; mode=shop lists a whole storefront. Shop product links use /shops/product/... URLs.
Is this affiliated with Mercari?
No. This is an independent third-party actor that reads public Mercari Japan listing data and is not operated by or affiliated with Mercari.
Python quickstart
Use a schema-derived input and the Python standard library to start a run. An Apify account and token are required for execution.
Source build R72wWR4KFU8fnAnNo. Documentation is regenerated from the default published build; private drafts are not included.