{ "openapi": "3.0.1", "info": { "title": "Mercari Scraper - Japan Listings, Prices and Sellers", "description": "Extract Mercari Japan listings, JPY prices, images, item details, seller profiles, categories and search filters. Search by keyword, URL or ID; pay per delivered row plus a run start fee.", "version": "0.1", "x-build-id": "jdvRvXiiqzfkA6v1W" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lentic_clockss~mercari-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lentic_clockss-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/lentic_clockss~mercari-scraper/runs": { "post": { "operationId": "runs-sync-lentic_clockss-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/lentic_clockss~mercari-scraper/run-sync": { "post": { "operationId": "run-sync-lentic_clockss-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": { "mode": { "title": "Mode", "enum": [ "auto", "search", "category", "brand", "item", "seller", "categories", "facets" ], "type": "string", "description": "Choose what to collect, or leave auto to select a mode from your target fields. Select categories or facets explicitly; seller mode returns a profile row and available listing rows within the same limit.", "default": "auto" }, "keyword": { "title": "Search keyword", "type": "string", "description": "Enter a search word or phrase, such as kindle; use Japanese product names when appropriate. Empty input starts a billed kindle example search capped at 10 rows." }, "searchQueries": { "title": "Search queries", "type": "array", "description": "Enter a list of search words or phrases. A nonempty list replaces keyword, and each query has its own maxResults allowance.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Enter Mercari Japan search, item, seller profile or category-tree URLs. A category or brand search URL without keyword= lists that page without applying the separate keyword field.", "items": { "type": "string" } }, "itemId": { "title": "Item ID", "type": "string", "description": "Enter one item ID, such as m60491956645, from the end of a Mercari Japan item URL." }, "sellerId": { "title": "Seller / user ID", "type": "string", "description": "Enter the numeric seller ID from the end of a Mercari Japan user/profile URL." }, "categoryId": { "title": "Category ID", "type": "string", "description": "Enter a Mercari category ID. Alone it selects category listings; with a keyword it narrows the search to that category." }, "brandId": { "title": "Brand ID", "type": "string", "description": "Enter a Mercari brand ID. Alone it selects brand listings; with a keyword it narrows the search to that brand." }, "maxResults": { "title": "Max results per input", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum rows per input, from 1 to 500; default 70, with larger allowances collected in parts of at most 70. All row types count, the run stops at your maximum total charge, and the Free plan allows 10 runs with at most 200 rows per run.", "default": 70 }, "sort": { "title": "Sort", "enum": [ "recommended", "created_time_desc", "price_asc" ], "type": "string", "description": "Choose recommended order, newest first or lowest price first for listing searches.", "default": "recommended" }, "status": { "title": "Listing status", "type": "string", "description": "Filter listing searches by status, such as on_sale or sold_out. Leave empty to avoid selecting a status." }, "priceMin": { "title": "Min price (JPY)", "type": "number", "description": "Optional minimum listing price in Japanese yen (JPY)." }, "priceMax": { "title": "Max price (JPY)", "type": "number", "description": "Optional maximum listing price in Japanese yen (JPY)." }, "itemConditionId": { "title": "Item condition ID", "type": "string", "description": "Optional Mercari condition ID for listing searches. Leave empty if you do not need a condition filter." }, "pageToken": { "title": "Page token", "type": "string", "description": "Optional search-page token for starting from a later page. Normally leave empty for automatic pagination." }, "enrichDetails": { "title": "Enrich item details", "type": "boolean", "description": "Add item details (items/get), such as description, photos, seller, shipping and category fields, to search, category and brand rows. This is off by default; it updates the same rows without adding a separate row charge.", "default": false }, "taxonomyDepth": { "title": "Taxonomy depth", "minimum": 1, "maximum": 4, "type": "integer", "description": "Category-tree depth for categories mode, from 1 to 4. The default is 3; maxResults also limits the number of category rows.", "default": 3 }, "useSeedPool": { "title": "Use recent category data", "type": "boolean", "description": "Allow previously collected category data when it is within seedPoolMaxAgeS. Turn off to request current category data instead.", "default": true }, "seedPoolMaxAgeS": { "title": "Maximum category-data age (seconds)", "minimum": 60, "type": "integer", "description": "Maximum age of previously collected category data, in seconds; default 86400 (24 hours). Older data is not used for the category tree.", "default": 86400 }, "workerBaseUrl": { "title": "Developer testing override", "type": "string", "description": "Leave empty. Used only by the developer for testing." } } }, "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 } } } } } } } } } }