{ "openapi": "3.0.1", "info": { "title": "Yahoo! Fleamarket Japan Scraper (Yahoo!フリマ / PayPayフリマ)", "description": "Scrape Yahoo! Fleamarket (Yahoo!フリマ, formerly PayPay フリマ) — Japan's second-largest C2C marketplace. Search by keyword, brand or category; get normalized listings (price JPY, size, condition, seller, images) with optional item details. No browser, no login. JP Data Works series.", "version": "0.2", "x-build-id": "fGAfQMHng2jiYFDBc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tokyo-select-jp~yahoo-fleamarket-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tokyo-select-jp-yahoo-fleamarket-search-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/tokyo-select-jp~yahoo-fleamarket-search-scraper/runs": { "post": { "operationId": "runs-sync-tokyo-select-jp-yahoo-fleamarket-search-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/tokyo-select-jp~yahoo-fleamarket-search-scraper/run-sync": { "post": { "operationId": "run-sync-tokyo-select-jp-yahoo-fleamarket-search-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", "uniqueItems": true, "type": "array", "description": "Simple keyword searches, one per line (e.g. `KAPITAL デニム`, `visvim FBT`, `ポケモンカード`). Each keyword is one search and inherits the defaults below. Optional when `searches` is set.", "default": [], "items": { "type": "string" } }, "searches": { "title": "Structured searches", "type": "array", "description": "Advanced searches as JSON objects. Each needs at least one of `keyword`, `brand`, `brandId`, `categoryPath`, `categoryId`.\n\n- `keyword` — free text.\n- `brand` — brand name as shown on the site (e.g. `KAPITAL`); resolved to the site's brand id by looking at the first search hit. `brandId` — the id directly (106095 = KAPITAL).\n- `categoryPath` — `mens`, `ladies`, `watches`, or a path such as `mens > jackets > coverall`, `メンズファッション > ジャケット > Gジャン、デニム`, `ladies > dresses`; `categoryId` — the site's category id (36588) or id path (13457/2495/36583/36588).\n- `priceMinJpy` / `priceMaxJpy` — client-side.\n- `conditionMin` — minimum condition rank 1–6 (6 = 新品、未使用; needs the item page, turns enrichDetail on).\n- `listedAfter` — ISO date or epoch seconds; only items listed after this (from the card's listing time).\n- `excludeWords` — drop items whose title contains any of these.\n- `sellerId` — keep only one seller's items.\n\nWith a keyword the Actor uses /search/?brandIds=&categoryIds=; without a keyword it walks the brand page or the category page (newest first).", "items": { "type": "object", "properties": { "keyword": { "type": "string", "title": "Keyword", "description": "Free-text search." }, "brand": { "type": "string", "title": "Brand name", "description": "Brand name as shown on the site; resolved to brandId." }, "brandId": { "type": "integer", "title": "Brand id", "description": "Site brand id, e.g. 106095 = KAPITAL." }, "categoryPath": { "type": "string", "title": "Category path", "description": "`mens`, `ladies`, `mens > jackets > coverall`, `メンズファッション > ジャケット` …" }, "categoryId": { "type": "string", "title": "Category id", "description": "Site category id (36588) or id path (13457/2495/36583/36588)." }, "priceMinJpy": { "type": "integer", "title": "Min price (JPY)", "description": "Lower price bound (client-side).", "minimum": 0 }, "priceMaxJpy": { "type": "integer", "title": "Max price (JPY)", "description": "Upper price bound (client-side).", "minimum": 0 }, "conditionMin": { "type": "integer", "title": "Min condition rank", "description": "6 新品、未使用, 5 未使用に近い, 4 目立った傷や汚れなし, 3 やや傷や汚れあり, 2 傷や汚れあり, 1 全体的に状態が悪い. Needs the item page.", "minimum": 1, "maximum": 6 }, "listedAfter": { "type": "string", "title": "Listed after", "description": "ISO date/time or epoch seconds." }, "excludeWords": { "type": "array", "title": "Exclude words", "description": "Drop items whose title contains any of these.", "items": { "type": "string" } }, "sellerId": { "type": "string", "title": "Seller id", "description": "Keep only this seller's items (id from /user/)." } } }, "default": [] }, "outputMode": { "title": "Output mode", "enum": [ "items", "summary", "both" ], "type": "string", "description": "`items` (default): one dataset row per listing. `summary`: one market-summary row per search instead of the listings — sample size, price min / p25 / median / mean / p75 / max, price histogram, status / condition-rank / size / brand / category breakdowns, cheapest listings — billed once per search as the `summary` event (the sampled listings are not billed). `both`: listings plus the summary row.", "default": "items" }, "priceMinJpy": { "title": "Default min price (JPY)", "minimum": 0, "type": "integer", "description": "Lower price bound for every search without its own `priceMinJpy` (client-side)." }, "priceMaxJpy": { "title": "Default max price (JPY)", "minimum": 0, "type": "integer", "description": "Upper price bound for every search without its own `priceMaxJpy` (client-side)." }, "conditionMin": { "title": "Default min condition rank", "minimum": 1, "maximum": 6, "type": "integer", "description": "Only listings with this condition rank or better (6 新品、未使用 … 1). Needs the item page, so it turns enrichDetail on." }, "listedAfter": { "title": "Default listed after", "type": "string", "description": "Only items listed after this date/time (ISO or epoch seconds). Combine with a schedule for incremental collection." }, "excludeWords": { "title": "Default exclude words", "type": "array", "description": "Drop items whose title contains any of these words (case-insensitive).", "default": [], "items": { "type": "string" } }, "maxItemsPerSearch": { "title": "Max items per search", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop after this many listings for each keyword / search (100 cards per page).", "default": 100 }, "maxTotalItems": { "title": "Max total items", "minimum": 1, "type": "integer", "description": "Hard cap on listings saved in this run across all searches." }, "dedupeAcrossSearches": { "title": "Deduplicate across searches", "type": "boolean", "description": "Save a listing only once when several searches return it.", "default": true }, "enrichDetail": { "title": "Enrich with item pages", "type": "boolean", "description": "Open each item page for condition, size, colour, gender, category path, seller (name, rating count, verified, badges), likes, shipping, description and the full gallery. One extra request and one `detail-page` event per item.", "default": false }, "maxDetailPages": { "title": "Max item pages per run", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Cap on item-page requests per run.", "default": 100 }, "requestDelayMs": { "title": "Delay between requests (ms)", "minimum": 1000, "maximum": 60000, "type": "integer", "description": "Minimum pause between requests. Keep ≥ 2000.", "default": 2000 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Not needed under normal use." }, "outputFields": { "title": "Output fields", "type": "array", "description": "Keep only these top-level fields (`itemId` and `url` are always kept).", "default": [], "items": { "type": "string" } } } }, "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 } } } } } } } } } }