{ "openapi": "3.0.1", "info": { "title": "AutoScout24 Motorrad — Motorrad, Roller und Quad", "description": "AutoScout24 Motorrad listings in Germany: title, price in EUR, make and detail URL. The site category also includes roller and quad, and those rows stay in the results. This is not road motorcycles only. No phone numbers. Use a Germany residential proxy on HTTP 403.", "version": "0.1", "x-build-id": "5Spdk26yBCRtOeJrn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/noahadler~autoscout24-motorrad/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-noahadler-autoscout24-motorrad", "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/noahadler~autoscout24-motorrad/runs": { "post": { "operationId": "runs-sync-noahadler-autoscout24-motorrad", "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/noahadler~autoscout24-motorrad/run-sync": { "post": { "operationId": "run-sync-noahadler-autoscout24-motorrad", "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": { "listingType": { "title": "Mode", "enum": [ "active", "sold_check", "both" ], "type": "string", "description": "active = live make/model search (default). sold_check = optional re-check of URLs you already have (ACTIVE|DELISTED). Not a sold-price archive.", "default": "active" }, "query": { "title": "Search query", "type": "string", "description": "Optional make or model. Empty browses the whole vehicle class." }, "make": { "title": "Make", "type": "string", "description": "Brand slug (e.g. BMW). Combined with model when query is empty." }, "model": { "title": "Model", "type": "string", "description": "Model (e.g. 3er, 320, Golf). BMW series numbers like 3 map to 3er." }, "listingUrls": { "title": "Listing URLs (optional status check)", "type": "array", "description": "Real AutoScout24 detail URLs only (no dummy IDs). Used when listingType is sold_check or both.", "items": { "type": "string" } }, "listingIds": { "title": "Listing IDs (optional status check)", "type": "array", "description": "Real AutoScout24 listing UUIDs from ads you already collected. Do not invent IDs.", "items": { "type": "string" } }, "portal": { "title": "Portal", "enum": [ "de", "at", "it" ], "type": "string", "description": "AutoScout24 country site: de (Germany), at (Austria), it (Italy).", "default": "de" }, "maxItems": { "title": "Max listings", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum active car listings to collect (1–200). ~20 ads per page.", "default": 40 }, "maxSoldChecks": { "title": "Max URL/ID status checks", "minimum": 1, "maximum": 100, "type": "integer", "description": "Cap for listingUrls+listingIds (1–100). Defaults to maxItems when omitted.", "default": 40 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Recommended: Apify RESIDENTIAL. If apifyProxyCountry is empty, the Actor injects DE/AT/IT from the selected portal. On HTTP 403 the run soft-fails with a clear error row.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }