{ "openapi": "3.0.1", "info": { "title": "Mercari Japan Scraper メルカリ: Sold Prices, Listings & Seller Data", "description": "Mercari Japan scraper (メルカリ) for live and sold listings by keyword, URL, item or seller: JPY and USD prices, condition, brand, shipping, seller ratings, photos, sold-price stats and a new-listing and price-drop monitor. No login, no cookies. Export to JSON, CSV or Excel.", "version": "1.2", "x-build-id": "9oU46VcXMBvG2jt9g" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~mercari-japan-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-mercari-japan-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/getascraper~mercari-japan-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-mercari-japan-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/getascraper~mercari-japan-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-mercari-japan-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": { "startUrls": { "title": "Mercari addresses", "type": "array", "description": "Paste Mercari Japan search pages, category pages, single item pages or seller profile pages. Item pages return one full record each, seller pages return that seller's listings. Add userData.inputId to tag the rows from an address.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "itemIds": { "title": "Item ids", "type": "array", "description": "Mercari item ids such as m89066779395. Each one returns a full record with seller, shipping and description.", "items": { "type": "string" } }, "sellerIds": { "title": "Seller ids", "type": "array", "description": "Numeric seller ids (the number in a seller profile address). Returns that seller's listings, with the status filter below applied.", "items": { "type": "string" } }, "keywords": { "title": "Search keywords", "type": "array", "description": "One or more English or Japanese searches. Each keyword is searched separately and the results are merged without duplicates. The sample keyword is ignored when you add addresses, item ids or seller ids.", "default": [ "apple watch" ], "items": { "type": "string" } }, "status": { "title": "Listing status", "type": "array", "description": "On sale for live listings. Sold out also covers items whose sale is in progress, which makes it the source for sold prices.", "items": { "type": "string", "enum": [ "on_sale", "sold_out", "trading" ], "enumTitles": [ "On sale", "Sold out", "Trading (sale in progress)" ] }, "default": [ "on_sale" ] }, "sort": { "title": "Sort by", "enum": [ "score", "created_time", "price", "num_likes" ], "type": "string", "description": "Order of the results: relevance, newest, price or most liked.", "default": "score" }, "order": { "title": "Sort direction", "enum": [ "desc", "asc" ], "type": "string", "description": "Descending shows the highest price or newest first, ascending the opposite.", "default": "desc" }, "priceMin": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Only listings priced at or above this amount in yen." }, "priceMax": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Only listings priced at or below this amount in yen." }, "itemConditionIds": { "title": "Condition", "type": "array", "description": "Keep only listings in these conditions. Leave empty for all conditions.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6" ], "enumTitles": [ "New, unused", "Almost new", "No noticeable scratches or marks", "Some scratches or marks", "Scratches or marks", "Bad condition" ] } }, "shippingPayer": { "title": "Who pays shipping", "enum": [ "any", "seller", "buyer" ], "type": "string", "description": "Seller means shipping is included in the price. Buyer means shipping is paid on delivery.", "default": "any" }, "sellerType": { "title": "Seller type", "enum": [ "any", "individual", "shops" ], "type": "string", "description": "Individual sellers only, Mercari Shops merchants only, or both.", "default": "any" }, "brandIds": { "title": "Brand ids", "type": "array", "description": "Mercari brand ids to include (the brand_id number in a Mercari search address).", "items": { "type": "string" } }, "categoryIds": { "title": "Category ids", "type": "array", "description": "Mercari category ids to include (the category_id number in a Mercari search address).", "items": { "type": "string" } }, "sizeIds": { "title": "Size ids", "type": "array", "description": "Mercari size ids to include (the size_id number in a Mercari search address).", "items": { "type": "string" } }, "shippingFromAreaIds": { "title": "Ship-from prefecture ids", "type": "array", "description": "Keep only items shipped from these prefectures, for example 13 for Tokyo.", "items": { "type": "string" } }, "excludeKeyword": { "title": "Exclude words", "type": "string", "description": "Skip listings whose text contains this word, for example junk or case." }, "fetchItemDetails": { "title": "Full item details", "type": "boolean", "description": "Open every listing to add the seller name and ratings, description, English title and description, all photos, shipping method, ship-from area, likes and comments. Slower than a plain scan.", "default": false }, "includeSoldStats": { "title": "Sold price statistics", "type": "boolean", "description": "For each keyword, add one summary row with the median, quartiles, range and average days to sell of recently sold items, and flag live listings priced below that median.", "default": false }, "jpyToUsdRate": { "title": "Yen to dollar rate", "minimum": 0, "type": "number", "description": "Optional. Dollars per yen, for example 0.0066. Leave empty to use the rate Mercari shows, which is added as price_usd when available." }, "maxResults": { "title": "Maximum total results", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Stops the run after this many listings across all sources.", "default": 25 }, "maxItemsPerQuery": { "title": "Maximum per source", "minimum": 1, "maximum": 15000, "type": "integer", "description": "Most listings taken from each keyword, address or seller.", "default": 25 }, "monitorMode": { "title": "Monitor changes", "type": "boolean", "description": "Remember this search between runs and report new listings, price drops, price rises and sold items. Run it on a schedule.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "A short name for this saved search, for example watches under 20000. Runs with the same name share one memory." }, "onlyChanges": { "title": "Only changes", "type": "boolean", "description": "Save only new, changed and sold listings. Turn off to also save listings that did not change.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Connection settings. The default connects directly and switches to an Apify datacenter proxy by itself if Mercari stops answering. Choose Apify proxy to always use one.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }