Dataspryva

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.

FieldTypeRequiredDescription
modestringoptionalHow to find listings.
keywordstringoptionalSearch term, in Japanese or English (mode=search).
startUrlsarrayoptionalSearch, item or shop links to scrape (mode=byUrl). Mixing link types is fine.
Show all input fields
FieldTypeRequiredDescription
modestringoptionalHow to find listings.
keywordstringoptionalSearch term, in Japanese or English (mode=search).
startUrlsarrayoptionalSearch, item or shop links to scrape (mode=byUrl). Mixing link types is fine.
shopstringoptionalShop ID, storefront URL or shop product URL (mode=shop).
statusstringoptionalOn sale, exact sold out, trading, sold (sold out plus trading, the site's sold filter), or all.
conditionstringoptionalFilter by Mercari's six condition grades.
sortBystringoptionalResult order.
categorystringoptionalCategory name, path or numeric ID, e.g. `ゲーム・おもちゃ・グッズ > テレビゲーム` or `7002`.
brandstringoptionalBrand name (Japanese or English) or numeric ID, e.g. `Nintendo`, `任天堂` or `15487`.
sizestringoptionalMercari size filter. The group name is shown before each size.
sellerTypestringoptionalIndividual sellers, Mercari Shops, or both.
excludeKeywordstringoptionalDrop listings whose title contains this word. Applied by Mercari's search.
minPriceintegeroptionalLowest price in Japanese yen.
maxPriceintegeroptionalHighest price in Japanese yen.
maxItemsintegeroptionalMaximum listings to save.
includeDetailsbooleanoptionalOpen 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.

FieldTypeRequiredDescription
resultsstringoptionalDataset 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 null or 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
}
{
  "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.

Open the step-by-step Python guide →

Source build R72wWR4KFU8fnAnNo. Documentation is regenerated from the default published build; private drafts are not included.