{ "openapi": "3.0.1", "info": { "title": "Rakuma Fril Japan Listings Scraper", "description": "First full Rakuma (fril.jp) listings actor: keyword search plus item-detail enrichment (condition, seller, shipping payer, price-drop flag) unifying what three shallow single-purpose scripts do separately.", "version": "0.4", "x-build-id": "zDgCuzvteNuhM5xRk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jungle_synthesizer~rakuma-fril-japan-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jungle_synthesizer-rakuma-fril-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/jungle_synthesizer~rakuma-fril-japan-listings-scraper/runs": { "post": { "operationId": "runs-sync-jungle_synthesizer-rakuma-fril-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/jungle_synthesizer~rakuma-fril-japan-listings-scraper/run-sync": { "post": { "operationId": "run-sync-jungle_synthesizer-rakuma-fril-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", "required": [ "query", "maxItems" ], "properties": { "sp_intended_usage": { "title": "What is the intended usage of this data?", "minLength": 1, "type": "string", "description": "What will this data feed? E.g. lead lists, KYB checks, price tracking." }, "sp_improvement_suggestions": { "title": "How can we improve this crawler for you?", "minLength": 1, "type": "string", "description": "Provide any feedback or suggestions for improvements." }, "sp_contact": { "title": "Contact email (optional)", "minLength": 1, "type": "string", "description": "We'll personally help with your use case. No spam." }, "resumeCursor": { "title": "Resume cursor (continue a previous run)", "type": "string", "description": "Leave empty for a fresh crawl. To CONTINUE a previous run where it stopped — without paying again for records you already received — paste the `resumeCursor` value from that run's Output (the run's OUTPUT key). Resume promptly: the previous run's data expires with your account's retention window (free tier: your ~10 most recent runs)." }, "maxItems": { "title": "Max Items", "type": "integer", "description": "Maximum number of records to scrape" }, "query": { "title": "Search Keyword", "type": "string", "description": "Japanese search keyword to query on fril.jp (e.g. \"腕時計\" for watches). Free-text — Rakuma keyword search accepts any term." }, "sortBy": { "title": "Sort results by", "enum": [ "relevance", "price_asc", "price_desc", "newest", "most_liked" ], "type": "string", "description": "Order of the search results, applied by Rakuma before Max Items is counted. With \"Price, lowest first\" and Max Items 10 you get the 10 lowest-priced results for the keyword.", "default": "relevance" }, "onSaleOnly": { "title": "On-sale listings only", "type": "boolean", "description": "Off by default, which returns sold and on-sale listings together. When on, sold listings are left out of the search before Max Items is counted.", "default": false }, "listingOnly": { "title": "Search results only (do not open each listing)", "type": "boolean", "description": "Off by default, which opens every listing for its condition, seller, shipping and full description. When on, only what the search results page itself shows is returned — title, price, sold/on-sale, price-drop badge, thumbnail and item URL. Much faster, and the detail-only fields come back empty.", "default": false }, "requiredPhrase": { "title": "Required phrase", "type": "string", "description": "Leave empty to keep every result Rakuma returns. When set, only listings carrying this exact phrase are returned, and the rest never count against Max Items. Matching ignores upper/lower case and full-width/half-width differences." }, "phraseScope": { "title": "Where the required phrase must appear", "enum": [ "title_or_description", "title" ], "type": "string", "description": "Only used when Required Phrase is set. \"Title only\" is the cheapest — a listing whose title misses the phrase is never opened. \"Title or description\" also opens each listing to read the seller's description, so a bundle that names the item only in its description still counts.", "default": "title_or_description" }, "maxScanned": { "title": "Max listings to look at", "type": "integer", "description": "Optional ceiling on how many search results are examined, matched or not. Leave empty for no ceiling. Use it so a phrase with few matches stops instead of paging to the end of the results." }, "maxDetailRequests": { "title": "Max listings to open", "type": "integer", "description": "Optional ceiling on how many listings are opened to read their details. Leave empty to let Max Items decide. Useful with Required Phrase, where the number that must be opened to fill Max Items depends on how many match." }, "stopOnRestriction": { "title": "Stop on first access restriction", "type": "boolean", "description": "Off by default. When on, the run ends as soon as Rakuma answers with HTTP 401, 403 or 429 or with a challenge page. That request is not retried, no further pages are requested, and the run keeps the same network identity from start to finish, one request at a time. Records saved before the stop are kept.", "default": 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 } } } } } } } } } }