{ "openapi": "3.0.1", "info": { "title": "Otto.de Product Scraper", "description": "[💰 $1.2 / 1K] Scrape products from Otto.de, Germany's leading online marketplace: name, brand, price, compare-at price, discount, sale flags, rating, review count, availability, colors, images and sustainability badges. Search by keyword or paste Otto.de URLs, sort six ways, and skip sponsored ads", "version": "1.0", "x-build-id": "iNV4rhDbpNemINTqq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~otto-de-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-otto-de-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/solidcode~otto-de-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-otto-de-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/solidcode~otto-de-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-otto-de-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": { "searchQueries": { "title": "Search Keywords", "type": "array", "description": "Keywords to search on Otto.de, such as 'shirt' or 'kaffeevollautomat'. Each keyword runs its own search and we build the search for you — no need to create URLs. Leave empty if you are pasting Otto.de URLs below.", "items": { "type": "string" } }, "startUrls": { "title": "Otto.de URLs", "type": "array", "description": "Paste Otto.de search or category page URLs, such as https://www.otto.de/suche/shirt/ or https://www.otto.de/damen/mode/shirts/. Both search and category pages are collected exactly as Otto scopes them, and any filters already in the pasted address (for example a price range) are kept. Leave empty if you are using search keywords above.", "items": { "type": "string" } }, "sortBy": { "title": "Sort Results By", "enum": [ "topseller", "preis-aufsteigend", "preis-absteigend", "hoechste-reduzierung", "neuheiten", "bewertung" ], "type": "string", "description": "Order in which products are collected. Otto returns different products first depending on this, so it also changes which products you get when you set a result limit." }, "minPrice": { "title": "Minimum Price (EUR)", "minimum": 0, "type": "integer", "description": "Only collect products priced at or above this amount, in euros. Leave empty for no lower limit. Otto applies this filter itself, so you are not billed for products outside your price range." }, "maxPrice": { "title": "Maximum Price (EUR)", "minimum": 0, "type": "integer", "description": "Only collect products priced at or below this amount, in euros. Leave empty for no upper limit. Otto applies this filter itself, so you are not billed for products outside your price range." }, "includeSponsored": { "title": "Include sponsored products", "type": "boolean", "description": "Otto mixes paid, sponsored products into its results (roughly 1 in 10). Leave this off to get a clean, ad-free product list — this also means you are not billed for ad placements. Turn it on if you want results exactly as a shopper sees them on the site. Every product is labelled 'organic' or 'sponsored' in the output either way." }, "maxResults": { "title": "Maximum Results", "minimum": 0, "type": "integer", "description": "Maximum number of products to return per search keyword or URL. Set to 0 to collect everything available, up to a safety limit of 50,000 products per run. Products are collected about 120 at a time, so the final count is rounded up to the end of the last page — asking for 50 may return about 120. Every returned product is billed. Tip: start with 100 to test, then increase." } } }, "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 } } } } } } } } } }