{
  "openapi": "3.0.1",
  "info": {
    "title": "Mercari Scraper - Japan & US Listings, Sold Prices & Sellers",
    "description": "Scrape Mercari Japan (jp.mercari.com, incl. Mercari Shops) and Mercari US listings by keyword, search URL, item or seller: price, on sale or sold, condition, brand, category, shipping, photos. Add-ons: item details, seller profiles, reviews, comments. Monitor mode. $1.30 / 1,000 JP listings.",
    "version": "0.1",
    "x-build-id": "gbvWeL768jhFWd9kj"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/topapi~mercari-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-topapi-mercari-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/topapi~mercari-scraper/runs": {
      "post": {
        "operationId": "runs-sync-topapi-mercari-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/topapi~mercari-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-topapi-mercari-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "searchQueries": {
            "title": "🔍 Search keywords",
            "type": "array",
            "description": "What you would type in Mercari's search box, one per line, e.g. \"nintendo switch\", \"ポケモンカード\", \"lululemon leggings\". Japanese and English keywords both work on Mercari Japan. Mercari URLs work here too.",
            "items": {
              "type": "string"
            }
          },
          "site": {
            "title": "🌏 Mercari site",
            "enum": [
              "jp",
              "us",
              "both"
            ],
            "type": "string",
            "description": "The site keywords, item ids and seller ids are read on. URLs keep their own site.",
            "default": "jp"
          },
          "startUrls": {
            "title": "🔗 Mercari URLs",
            "type": "array",
            "description": "Pages copied from your browser: searches with their filters (jp.mercari.com/search?keyword=…&status=sold_out, mercari.com/search/?keyword=…&itemStatuses=2-3), item pages (/item/m…, /us/item/m…, /shops/product/…), Mercari Japan seller and shop pages (/user/profile/…, /shops/profile/…).",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "urlsFromFile": {
            "title": "URLs from a file",
            "type": "string",
            "description": "Many URLs at once: paste them one per line, or one link to a .txt / .csv file that lists them."
          },
          "itemIds": {
            "title": "Item ids",
            "type": "array",
            "description": "Listing ids such as m39088208848 (on the chosen site) or Mercari Shops product ids. Each comes back as one full row with its details.",
            "items": {
              "type": "string"
            }
          },
          "sellerIds": {
            "title": "Seller ids",
            "type": "array",
            "description": "Mercari Japan seller ids (the number in /user/profile/123456789) or Mercari Shops shop ids: their listings, newest first. Mercari US seller pages are not supported (see Limits).",
            "items": {
              "type": "string"
            }
          },
          "status": {
            "title": "Status",
            "type": "array",
            "description": "On sale, sold, or both. Sold also covers listings in trade, as on Mercari. Empty = every status.",
            "items": {
              "type": "string",
              "enum": [
                "on_sale",
                "sold_out",
                "trading"
              ],
              "enumTitles": [
                "On sale",
                "Sold",
                "In trade (paid, not yet completed)"
              ]
            },
            "default": [
              "on_sale"
            ]
          },
          "sort": {
            "title": "Sort by",
            "enum": [
              "score",
              "created_time",
              "price",
              "num_likes",
              "recently_sold"
            ],
            "type": "string",
            "description": "Mercari's own order. Newest reads past the site's per-search window (12,000 on Mercari Japan, 1,000 on Mercari US) in creation-time windows.",
            "default": "score"
          },
          "order": {
            "title": "Order",
            "enum": [
              "desc",
              "asc"
            ],
            "type": "string",
            "description": "With Price: asc = cheapest first. Mercari US has no oldest-first order.",
            "default": "desc"
          },
          "priceMin": {
            "title": "Minimum price",
            "minimum": 0,
            "type": "integer",
            "description": "In the site's currency: yen on Mercari Japan, dollars on Mercari US. e.g. 3000 (JPY) or 25 (USD)."
          },
          "priceMax": {
            "title": "Maximum price",
            "minimum": 0,
            "type": "integer",
            "description": "In the site's currency: yen on Mercari Japan, dollars on Mercari US."
          },
          "conditions": {
            "title": "Condition",
            "type": "array",
            "description": "Mercari's condition grades. Empty = any condition.",
            "items": {
              "type": "string",
              "enum": [
                "new",
                "like_new",
                "good",
                "fair",
                "poor",
                "bad"
              ],
              "enumTitles": [
                "New / unused",
                "Like new (Almost new)",
                "Good (no noticeable scratches)",
                "Fair (some scratches)",
                "Poor (scratches / marks)",
                "Bad condition (Mercari Japan)"
              ]
            }
          },
          "categoryIds": {
            "title": "Category ids",
            "type": "array",
            "description": "Mercari category ids, e.g. 7002 (Nintendo Switch on Mercari Japan) or 84 (Video games & consoles on Mercari US). The number in a category URL's category_id / categoryIds.",
            "items": {
              "type": "string"
            }
          },
          "brandIds": {
            "title": "Brand ids",
            "type": "array",
            "description": "Mercari brand ids, e.g. 15487 (Nintendo on Mercari Japan) or 4591 (Nintendo on Mercari US). The number in a URL's brand_id / brandIds.",
            "items": {
              "type": "string"
            }
          },
          "sizeIds": {
            "title": "Size ids",
            "type": "array",
            "description": "Mercari size ids (size_id / sizeIds in a search URL).",
            "items": {
              "type": "string"
            }
          },
          "shippingPayer": {
            "title": "Shipping paid by",
            "enum": [
              "any",
              "seller",
              "buyer"
            ],
            "type": "string",
            "description": "Who pays shipping.",
            "default": "any"
          },
          "colorIds": {
            "title": "Colour ids (Mercari Japan)",
            "type": "array",
            "description": "Mercari Japan colour ids: 1 black, 2 white, 3 gray, 4 brown, 5 red, 6 pink, 7 purple, 8 blue, 9 beige, 10 green, 11 yellow, 12 orange.",
            "items": {
              "type": "string"
            }
          },
          "shippingFromAreaIds": {
            "title": "Ships from prefecture ids (Mercari Japan)",
            "type": "array",
            "description": "Prefecture ids 1-47 (1 Hokkaido … 13 Tokyo … 27 Osaka … 47 Okinawa).",
            "items": {
              "type": "string"
            }
          },
          "shippingOptions": {
            "title": "Shipping options (Mercari Japan)",
            "type": "array",
            "description": "Mercari Japan's shipping filter.",
            "items": {
              "type": "string",
              "enum": [
                "anonymous",
                "japan_post",
                "no_option"
              ],
              "enumTitles": [
                "Anonymous shipping",
                "Japan Post",
                "No option"
              ]
            }
          },
          "sellerType": {
            "title": "Seller type (Mercari Japan)",
            "enum": [
              "any",
              "individual",
              "shops"
            ],
            "type": "string",
            "description": "Mercari Japan lists items from individuals and from Mercari Shops businesses.",
            "default": "any"
          },
          "excludeKeyword": {
            "title": "Exclude keyword",
            "type": "string",
            "description": "Mercari's own exclude filter (Mercari Japan), e.g. \"ジャンク\" or \"case\"."
          },
          "postedWithinDays": {
            "title": "Posted within days",
            "minimum": 0,
            "maximum": 3650,
            "type": "integer",
            "description": "Only listings created in the last N days (Mercari's own creation-time filter). 0 = any time. Pairs well with a daily schedule."
          },
          "postedAfter": {
            "title": "Posted after",
            "type": "string",
            "description": "Only listings created on or after this date."
          },
          "soldWithinDays": {
            "title": "Sold within days",
            "minimum": 0,
            "maximum": 3650,
            "type": "integer",
            "description": "Sold listings of the last N days. Mercari US filters by the moment of the sale; Mercari Japan publishes no sale time, so its last update stands for it. Sets Status to sold."
          },
          "includeKeywords": {
            "title": "Title must contain",
            "type": "array",
            "description": "Keep only listings whose title (or brand) contains every one of these words, e.g. \"oled\".",
            "items": {
              "type": "string"
            }
          },
          "excludeKeywords": {
            "title": "Title must not contain",
            "type": "array",
            "description": "Drop listings whose title contains any of these words, e.g. \"junk\", \"broken\", \"box only\".",
            "items": {
              "type": "string"
            }
          },
          "onlyBelowSoldMedian": {
            "title": "Only below the sold median",
            "type": "boolean",
            "description": "Keep only on-sale listings priced under the median price of the same search's recent sold listings (turns on the price summary).",
            "default": false
          },
          "includeDetails": {
            "title": "Item details",
            "type": "boolean",
            "description": "Read each listing's page data: full description, every photo, likes, comment count, ship-from area, shipping days and fee, attributes, hashtags, the seller's name and rating; Mercari US adds the sale time, total price with buyer protection and shipping class. Add-on: $0.0013 per listing.",
            "default": false
          },
          "includeSellerProfiles": {
            "title": "Seller profiles",
            "type": "boolean",
            "description": "One extra row per seller: rating and counts, listings, sales (US), followers, verification, join date, introduction. Charged once per seller per run: $0.0013.",
            "default": false
          },
          "includeSellerReviews": {
            "title": "Seller reviews",
            "type": "boolean",
            "description": "One row per review left on each seller: good / normal / bad, text, buyer or seller side, date, reviewer, feedback tags (US). $0.001 per review.",
            "default": false
          },
          "maxReviewsPerSeller": {
            "title": "Reviews per seller",
            "minimum": 1,
            "maximum": 2000,
            "type": "integer",
            "description": "Newest first.",
            "default": 20
          },
          "includeComments": {
            "title": "Comments (Mercari Japan)",
            "type": "boolean",
            "description": "One row per comment on each listing: text, time, commenter, whether the seller wrote it. $0.0009 per comment.",
            "default": false
          },
          "includeTranslation": {
            "title": "English translation (Mercari Japan)",
            "type": "boolean",
            "description": "Adds Mercari Japan's own English translation of each listing's title and description (title_en, description_en). Not charged.",
            "default": false
          },
          "currency": {
            "title": "Second currency (Mercari Japan)",
            "enum": [
              "none",
              "USD",
              "EUR",
              "GBP",
              "AUD",
              "CAD",
              "CNY",
              "HKD",
              "TWD",
              "KRW",
              "SGD",
              "THB",
              "MYR",
              "PHP",
              "IDR",
              "VND",
              "NZD",
              "CHF"
            ],
            "type": "string",
            "description": "Adds price_converted at Mercari Japan's own exchange rate. Not charged.",
            "default": "none"
          },
          "priceSummary": {
            "title": "Price summary per search",
            "type": "boolean",
            "description": "One summary row per search (not charged): median, quartiles, min, max and mean of recent sold listings, median asking price, ask-vs-sold gap, sell-through where Mercari's counts allow; every listing gets sold_median_price and vs_sold_median_pct.",
            "default": false
          },
          "monitorMode": {
            "title": "Monitor mode (only new listings)",
            "type": "boolean",
            "description": "Each run delivers only listings not delivered by earlier runs of the same search (newest first, stops at the first page with nothing new). An empty poll costs nothing.",
            "default": false
          },
          "monitorStoreName": {
            "title": "Monitor name",
            "type": "string",
            "description": "Named key-value store that remembers what was delivered. Use a different name per independent monitor.",
            "default": "mercari-monitor"
          },
          "monitorChanges": {
            "title": "Also price drops and status changes",
            "type": "boolean",
            "description": "Deliver a listing seen before again when its price dropped or its status changed (e.g. sold), with change_type, previous_price and previous_status.",
            "default": false
          },
          "skipFirstRun": {
            "title": "Skip first run",
            "type": "boolean",
            "description": "The first monitor run only remembers the current listings (nothing delivered, nothing charged); later runs deliver what is new.",
            "default": false
          },
          "resetMonitor": {
            "title": "Reset monitor memory",
            "type": "boolean",
            "description": "Forget what this monitor delivered before.",
            "default": false
          },
          "webhookUrl": {
            "title": "Webhook URL",
            "type": "string",
            "description": "POST the new listings (JSON) to your endpoint after each run that found some."
          },
          "slackWebhookUrl": {
            "title": "Slack webhook URL",
            "type": "string",
            "description": "Slack incoming-webhook URL for a short message with the new listings."
          },
          "discordWebhookUrl": {
            "title": "Discord webhook URL",
            "type": "string",
            "description": "Discord channel webhook URL."
          },
          "telegramToken": {
            "title": "Telegram bot token",
            "type": "string",
            "description": "Your Telegram bot's token (with the chat id below)."
          },
          "telegramChatId": {
            "title": "Telegram chat id",
            "type": "string",
            "description": "The chat or channel id the bot posts to."
          },
          "notificationLimit": {
            "title": "Listings per alert",
            "minimum": 0,
            "maximum": 50,
            "type": "integer",
            "description": "How many listings each alert message names.",
            "default": 10
          },
          "maxResults": {
            "title": "Max listings",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "Total listing rows per run (seller, review, comment and summary rows not counted). 0 = no limit. Mercari serves up to 12,000 listings per Japan search and 1,000 per US search in one order; newest-first reads past both.",
            "default": 100
          },
          "maxResultsPerSearch": {
            "title": "Max listings per search",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "Cap for each keyword or URL. Empty or 0 = only the total cap."
          },
          "maxItemsPerSeller": {
            "title": "Max listings per seller",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "Cap for each seller id or seller / shop URL. Empty or 0 = only the total cap."
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Optional. Without it the run reads directly and moves to Apify's datacenter, then residential proxy only if Mercari refuses."
          },
          "maxConcurrency": {
            "title": "Max concurrency",
            "minimum": 1,
            "maximum": 16,
            "type": "integer",
            "description": "Requests in flight for details, profiles and translations.",
            "default": 8
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}