{ "openapi": "3.0.1", "info": { "title": "Otto.de Product Scraper - Prices, Ratings & Listings", "description": "Scrape otto.de product listings in bulk: brand, title, price, UVP/list price, discount, star rating, reviews, availability, key specs, colours and image. Paste any Otto search or category URL or a keyword - it paginates deep for thousands of products per run. No login or API key.", "version": "0.1", "x-build-id": "xGyXoPPVCzULEz8dw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapeworks~otto-de-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapeworks-otto-de-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/scrapeworks~otto-de-product-scraper/runs": { "post": { "operationId": "runs-sync-scrapeworks-otto-de-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/scrapeworks~otto-de-product-scraper/run-sync": { "post": { "operationId": "run-sync-scrapeworks-otto-de-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": { "startUrls": { "title": "Otto.de listing URLs", "uniqueItems": true, "type": "array", "description": "One or more otto.de listing pages to scrape. Each can be a search-results URL (e.g. https://www.otto.de/suche/laptop/) or a category browse page (e.g. https://www.otto.de/moebel/). To get a URL: open otto.de, search or browse to the products you want, and copy the page URL from your browser. Every URL is paginated DEEP automatically (a broad term exposes thousands of products), so a few URLs return thousands of rows. Results are billed per product, so more URLs = more rows.", "items": { "type": "string" } }, "searchKeywords": { "title": "Search keywords (optional)", "uniqueItems": true, "type": "array", "description": "Optional convenience: keywords to search otto.de for (each becomes a https://www.otto.de/suche// search and is paginated deep). Use whole product terms in German for the best coverage (e.g. 'sneaker', 'kaffeemaschine', 'gaming stuhl'). Every keyword is paginated deep just like a start URL.", "items": { "type": "string" } }, "maxResultsPerUrl": { "title": "Max results per start URL", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Maximum products to return for EACH start URL or keyword. The actor paginates automatically through Otto's whole listing. Set high to pull a whole search/category; lower it to sample.", "default": 5000 }, "maxPagesPerUrl": { "title": "Max result windows per start URL", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Safety cap on how many result windows to fetch per start URL (each window is 18 products). This is an upper bound on top of Max results per start URL; the actor also stops automatically at the listing's real last page. Raise it only if you set a very high Max results per start URL.", "default": 400 }, "maxResults": { "title": "Max results overall (optional)", "minimum": 1, "maximum": 500000, "type": "integer", "description": "Optional overall cap across ALL start URLs and keywords combined. Leave empty for no overall cap (each URL is still bounded by Max results / Max windows per URL). Useful to cap total billed rows for a run." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Fallback proxy for reaching otto.de. The actor fetches DIRECTLY first with a real Chrome TLS fingerprint (Otto's pages and tile-list feed return fine this way) and only routes through this proxy - rotating exits - if a request is blocked. The default (Apify Proxy, Germany) is a safe fallback; leave it in place. otto.de is a German store, so prices are always in EUR regardless of proxy country.", "default": { "useApifyProxy": true, "apifyProxyCountry": "DE" } } } }, "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 } } } } } } } } } }