{ "openapi": "3.0.1", "info": { "title": "Mercari Japan Scraper - Listings, Prices & Sold Items", "description": "Scrapes Mercari Japan (jp.mercari.com) listings: price in JPY, on-sale or sold status, condition, category, brand, photos, shipping, seller rating and description. Search by keyword with filters, or use search, item, shop product and seller profile URLs.", "version": "1.0", "x-build-id": "vBavgLJSecT3Jncbr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/confidential_gnat~mercari-japan-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-confidential_gnat-mercari-japan-listings-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/confidential_gnat~mercari-japan-listings-scraper/runs": { "post": { "operationId": "runs-sync-confidential_gnat-mercari-japan-listings-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/confidential_gnat~mercari-japan-listings-scraper/run-sync": { "post": { "operationId": "run-sync-confidential_gnat-mercari-japan-listings-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 Japan URLs", "type": "array", "description": "jp.mercari.com search URLs with any filters (for example https://jp.mercari.com/search?keyword=nintendo%20switch&status=on_sale), item pages (https://jp.mercari.com/item/m12345678901), Mercari Shops product pages (https://jp.mercari.com/shops/product/...) or seller profiles (https://jp.mercari.com/user/profile/123456789).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "scrapeDetails": { "title": "Scrape item details", "type": "boolean", "description": "Open each item to add the description, condition name, category path, shipping details, likes, comments and seller name and rating. One extra request per item.", "default": false }, "maxItems": { "title": "Max items per search", "minimum": 1, "type": "integer", "description": "Maximum listings saved for each search URL, seller or keyword. Mercari returns at most 15,000 results per search; narrow it with price ranges for more.", "default": 5 }, "cacheProjectName": { "title": "Cache project name", "type": "string", "description": "Use the same name on each scheduled run to get only new listings. Items already scraped under this name are skipped and not charged, and they do not count towards Max items. Each record gets changeType: new." }, "keywords": { "title": "Search keywords", "type": "array", "description": "Keywords to search, in Japanese or English (for example ポケモンカード or iPhone 15). Each keyword is a separate search that uses the filters below.", "items": { "type": "string" } }, "excludeKeyword": { "title": "Exclude keyword", "type": "string", "description": "Skip listings that contain this word (keyword searches only)." }, "status": { "title": "Status", "enum": [ "on_sale", "sold_out", "all" ], "type": "string", "description": "On sale, sold (sold or in trade, useful for price comps) or all listings. Applies to keyword searches; URLs keep their own filters.", "default": "on_sale" }, "sort": { "title": "Sort by", "enum": [ "created_time", "score", "price", "num_likes" ], "type": "string", "description": "Sort order of keyword searches.", "default": "created_time" }, "order": { "title": "Order", "enum": [ "desc", "asc" ], "type": "string", "description": "Descending or ascending (for example ascending + Price = cheapest first).", "default": "desc" }, "priceMin": { "title": "Min price (JPY)", "minimum": 0, "type": "integer", "description": "Lowest price in yen." }, "priceMax": { "title": "Max price (JPY)", "minimum": 0, "type": "integer", "description": "Highest price in yen." }, "categoryIds": { "title": "Category IDs", "type": "array", "description": "Mercari category IDs (the category_id value in a jp.mercari.com search URL), for example 702 for Nintendo Switch games.", "items": { "type": "string" } }, "conditionIds": { "title": "Item condition", "type": "array", "description": "Only these conditions. Leave empty for all.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6" ], "enumTitles": [ "New, unused", "Like new", "No visible damage", "Some damage", "Damaged", "Bad condition" ] } }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Mercari Japan works without a proxy. Enable Apify Proxy only if you get blocked.", "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 } } } } } } } } } }