{ "openapi": "3.0.1", "info": { "title": "Mercari Japan Scraper – Listings & Sold Comps", "description": "Scrape listings and real sold prices from Mercari Japan, the largest C2C marketplace. Get titles, prices, condition, sold status, seller, and images as JSON. Filter to sold-only for price research, or combine with our Yahoo! Auctions and Rakuma scrapers for cross-marketplace comps.", "version": "0.0", "x-build-id": "r62Sw1dBwliLtc8F9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datalab-jp~mercari-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datalab-jp-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/datalab-jp~mercari-scraper/runs": { "post": { "operationId": "runs-sync-datalab-jp-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/datalab-jp~mercari-scraper/run-sync": { "post": { "operationId": "run-sync-datalab-jp-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": { "searchKeyword": { "title": "Search keyword", "type": "string", "description": "Keyword to search for on Mercari Japan, e.g. 'ポケモンカード' (Pokémon cards) or 'ガンプラ' (Gundam model kits). Japanese keywords return the most results because Mercari is a Japanese marketplace, but English brand names such as 'Nintendo Switch' or 'Supreme' also work. Each matching listing becomes one row in the output dataset (one billable result). Set the `status` field to 'sold_out' to research real sold prices instead of asking prices.", "default": "ポケモンカード" }, "status": { "title": "Listing status", "enum": [ "all", "on_sale", "sold_out" ], "type": "string", "description": "Filter results by listing status. 'all' returns every matching listing (default). 'on_sale' returns only items currently for sale, which is best for sourcing and checking current stock. 'sold_out' returns only completed sales, i.e. actual transaction prices — use this for sold-price and comps research rather than asking prices. If omitted, defaults to 'all'.", "default": "all" }, "sortBy": { "title": "Sort by", "enum": [ "score", "created", "priceHigh", "priceLow", "likes" ], "type": "string", "description": "Sort order for the results, mirroring the sort options on the Mercari website. 'score' is Mercari's recommended relevance ranking (default). 'created' sorts newest listings first. 'priceHigh' and 'priceLow' sort by price descending and ascending. 'likes' sorts most-liked first. If omitted, defaults to 'score'.", "default": "score" }, "priceMin": { "title": "Minimum price (JPY, optional)", "type": "integer", "description": "Optional lower price bound in Japanese yen (JPY). Only listings priced at or above this amount are returned — for example, set it to 1000 to exclude cheap accessories. Leave empty to apply no minimum. Works together with `priceMax` to define a price range." }, "priceMax": { "title": "Maximum price (JPY, optional)", "type": "integer", "description": "Optional upper price bound in Japanese yen (JPY). Only listings priced at or below this amount are returned — for example, set it to 5000 to focus on budget items. Leave empty to apply no maximum. Works together with `priceMin` to define a price range." }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of listings to return across all pages. Each returned item is one billable result, so this is the main cost control. Defaults to 100 if omitted, and accepts values from 1 to 5000. The Actor paginates automatically and stops once this limit is reached or there are no more matching results.", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy configuration. Mercari's search API sits behind bot detection that has blocked datacenter IPs for other Japanese marketplaces from this account, so this Actor defaults to a Japan-based residential proxy (RESIDENTIAL group, country JP) for reliability. You can override the group or country here, but datacenter proxies may be blocked. Note that residential proxy traffic costs more per GB than datacenter proxy.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "JP" } } } }, "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 } } }, "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 } } } } } } } } } }