{ "openapi": "3.0.1", "info": { "title": "Mercari Sold Comps Scraper: Sold Listings & Sell-Through Rate", "description": "Mercari sold listings and sold comps for Japan and US: real sold prices, median and quartiles, days to sell, sell-through rate and a suggested max buy price per keyword. Filter by condition and price, paste search pages, export CSV or JSON. No login or cookies needed.", "version": "1.4", "x-build-id": "AjSZamz84vDxXtfrU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~mercari-sold-comps-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-mercari-sold-comps-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-sold-comps-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-mercari-sold-comps-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-sold-comps-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-mercari-sold-comps-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": { "keywords": { "title": "Keywords", "type": "array", "description": "Items to price, for example 'apple watch series 9' or 'nintendo switch oled'. Each keyword is searched on its own and gets its own price summary.", "default": [ "apple watch series 9" ], "items": { "type": "string" } }, "startUrls": { "title": "Search page links", "type": "array", "description": "Optional. Paste Mercari Japan (jp.mercari.com) or Mercari US (mercari.com) search pages. Your filters in the link are kept and the sold version of the search is used. Pasted links are searched in addition to the keywords.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "region": { "title": "Marketplace for keywords", "enum": [ "JAPAN", "US" ], "type": "string", "description": "Mercari Japan (prices in yen) or Mercari US (prices in dollars) for the keywords above. Pasted links use their own marketplace. Mercari US runs cost more because they need a US residential connection.", "default": "JAPAN" }, "priceMin": { "title": "Minimum sold price", "minimum": 0, "type": "integer", "description": "Optional. Ignore sales below this price (yen for Japan, whole dollars for US)." }, "priceMax": { "title": "Maximum sold price", "minimum": 0, "type": "integer", "description": "Optional. Ignore sales above this price (yen for Japan, whole dollars for US)." }, "conditions": { "title": "Condition", "type": "array", "description": "Optional. Only count items in these conditions. Leave empty for all conditions.", "items": { "type": "string", "enum": [ "new", "like_new", "good", "fair", "poor" ], "enumTitles": [ "New", "Like new", "Good", "Fair", "Poor" ] } }, "sortBy": { "title": "Which sales first", "enum": [ "newest", "relevance" ], "type": "string", "description": "Newest listings first gives the most recent price picture. Best match follows the site's own ranking.", "default": "newest" }, "soldWithinDays": { "title": "Sold within the last days", "minimum": 1, "maximum": 365, "type": "integer", "description": "Optional, Mercari Japan only. Keep sales from the last N days. Mercari US does not publish a sale date." }, "maxSoldPerKeyword": { "title": "Sold listings per keyword", "minimum": 1, "maximum": 600, "type": "integer", "description": "How many sold listings to collect per keyword. 50 to 200 gives steadier medians; more costs more.", "default": 25 }, "computeSellThrough": { "title": "Add sell-through rate", "type": "boolean", "description": "Also count listings still for sale and report the sold share: sold / (sold + for sale). Adds one extra page load per keyword.", "default": true }, "targetMarginPercent": { "title": "Margin you want (%)", "minimum": 0, "maximum": 95, "type": "integer", "description": "Used for the suggested maximum buy price in each summary: the median sold price, minus the selling fee, minus this margin.", "default": 30 }, "sellerFeePercent": { "title": "Selling fee (%)", "minimum": 0, "maximum": 50, "type": "integer", "description": "The marketplace fee taken from a sale, used for the suggested maximum buy price. Mercari charges 10% by default; change it if your fee differs.", "default": 10 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Mercari Japan connects directly and switches to an Apify datacenter proxy by itself if Mercari stops answering. Mercari US always uses a US residential proxy unless you add your own proxy links.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }