{ "openapi": "3.0.1", "info": { "title": "Japan Flea Market Scraper – Rakuma & Yahoo! Flea Market", "description": "Scrape listings from Japan's flea-market apps Rakuma (fril.jp) and Yahoo! Flea Market (formerly PayPay Flea Market) in one Actor. Get titles, prices, status, category, and images as clean JSON, with sold-only filtering on Rakuma for price research. No code required.", "version": "0.0", "x-build-id": "76f5gAbdu0WO9xqoC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datalab-jp~japan-flea-market-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datalab-jp-japan-flea-market-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~japan-flea-market-scraper/runs": { "post": { "operationId": "runs-sync-datalab-jp-japan-flea-market-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~japan-flea-market-scraper/run-sync": { "post": { "operationId": "run-sync-datalab-jp-japan-flea-market-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": { "marketplace": { "title": "Marketplace", "enum": [ "rakuma", "yahoo-fleamarket" ], "type": "string", "description": "Which Japanese flea-market platform to search: 'rakuma' for Rakuma (fril.jp, Rakuten's C2C marketplace) or 'yahoo-fleamarket' for Yahoo! Flea Market (formerly PayPay Flea Market). Must be exactly one of the two enum values below; any other string is rejected. If omitted, defaults to 'rakuma'. This choice changes which other fields apply: only Rakuma supports 'soldout' in `listingStatus`, and Rakuma runs auto-upgrade to a Japan residential proxy unless you set `proxyConfiguration` yourself.", "default": "rakuma" }, "searchKeyword": { "title": "Search keyword", "type": "string", "description": "Keyword to search for on the selected marketplace, e.g. 'ポケモン' (Pokémon) or 'ワンピース フィギュア' (One Piece figure). Japanese keywords return the most results since both Rakuma and Yahoo! Flea Market are Japanese-only, though romanized brand names often work too. There is no run-time default: the Console pre-fills 'ポケモン', but if the input is sent via the API without this field the Actor throws an error. Each matching listing is one row and one billable result, subject to `maxItems`.", "default": "ポケモン" }, "listingStatus": { "title": "Listing status", "enum": [ "all", "selling", "soldout" ], "type": "string", "description": "Filter results by listing status: 'all' returns every matching listing, 'selling' returns only items currently for sale, and 'soldout' returns only completed sales (useful for sold-price research). Must be one of these three enum values. If omitted, defaults to 'all'. 'soldout' only works on Rakuma — when `marketplace` is 'yahoo-fleamarket' this field is ignored (Yahoo! Flea Market always returns on-sale listings) and the Actor logs a warning rather than failing.", "default": "all" }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of listings to return, e.g. 100 for a quick sample or 2000 for a broad price survey. Must be an integer between 1 and 5000; the Actor paginates automatically (40 listings per page on Rakuma, 100 per page on Yahoo! Flea Market) until this limit is reached or results run out. If omitted, defaults to 100. Each returned item is one billable result under pay-per-event pricing, so this field is the main lever for controlling run cost regardless of which `marketplace` is selected.", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy settings for all requests, e.g. the default `{\"useApifyProxy\": true}` or a custom object pinning a proxy group/country. If you leave this at default and pick 'rakuma' in `marketplace`, the Actor automatically upgrades to Japan residential (`apifyProxyGroups: [\"RESIDENTIAL\"]`, `apifyProxyCountry: \"JP\"`) because Rakuma's WAF blocks datacenter IPs with 403. Yahoo! Flea Market works on cheaper datacenter proxies, and setting your own group/country here disables the automatic upgrade.", "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 } } }, "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 } } } } } } } } } }