{ "openapi": "3.0.1", "info": { "title": "Japanwelt Product Scraper - Prices, Stock, SKUs", "description": "Export the Japanwelt catalogue: prices, per-unit prices, availability, delivery times, SKUs, brands, ratings and category paths for Japanese food, tea, tableware, futons and games.", "version": "1.0", "x-build-id": "fp3IrplBJfvIpJEpb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~japanwelt-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-japanwelt-product-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/sian.agency~japanwelt-product-scraper/runs": { "post": { "operationId": "runs-sync-sian.agency-japanwelt-product-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/sian.agency~japanwelt-product-scraper/run-sync": { "post": { "operationId": "run-sync-sian.agency-japanwelt-product-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": { "operation": { "title": "🎛️ Operation", "enum": [ "catalog", "productDetail" ], "type": "string", "description": "Catalogue searches the shop for your keywords, or walks the shop categories you name, and returns one row per product with price, per-unit price, pack content, availability and listing position. Product detail takes product page links and returns one deeper row each: SKU, brand, manufacturer part number, category path, delivery time, the specification table, the full description and the image gallery.", "default": "catalog" }, "searchTerms": { "title": "🔍 Search terms", "type": "array", "description": "German search words, one per line. The shop is German, so German words find the most: matcha returned 109 products, tee 276, futon, tatami, sake, shoji, bento, sushi, kimono and go-brett all return their own shelves. Each term is searched separately and every product it returns becomes a row. Leave this empty AND leave the category links empty to walk the whole shop instead. Ignored in product detail mode.", "default": [ "matcha" ], "items": { "type": "string" } }, "categoryUrls": { "title": "📂 Shop category links", "type": "array", "description": "Optional. Paste shop category links such as https://www.japanwelt.de/teezeremonie/gruentee-matcha/ or https://www.japanwelt.de/futon-betten/ to take whole shelves instead of searching. A department link takes everything under it - the Wohnen department returned 211 products in a single request. Rows from a category link also carry the link they came from, so a run over several categories stays sortable by shelf.", "default": [], "items": { "type": "string" } }, "sortBy": { "title": "↕️ Sort listings by", "enum": [ "relevance", "newest", "popularity", "priceAsc", "priceDesc", "name" ], "type": "string", "description": "The order the shop returns products in, which decides what you get when the maximum cuts the run short. Cheapest first and most expensive first were both verified against real listings before this option was offered. Applies to search terms and category links alike; ignored in product detail mode.", "default": "relevance" }, "productUrls": { "title": "🔗 Product page links", "type": "array", "description": "Product page links to read in detail. Required when the operation is product detail, ignored otherwise. Each link returns one row carrying the SKU, brand, manufacturer part number, the shop's own category path, availability, delivery time, the specification table, the published description and every gallery image. Catalogue rows carry the product link, so a catalogue run feeds this field directly.", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "🔢 Maximum products", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Upper bound on the products a run returns, and therefore on what it can charge. The whole shop is about 4,781 products, so raise this to 5000 for a complete export and leave both the search terms and the category links empty. Reached, the run stops and reports the cap in the run report.", "default": 25 } } }, "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 } } } } } } } } } }