{ "openapi": "3.0.1", "info": { "title": "autoscout24 nutzfahrzeuge", "description": "AutoScout24 Nutzfahrzeuge listings in Germany: commercial vans such as Fiorino, Caddy, Transit, Master and Kangoo. Rows include title, price in EUR, make and detail URL. Not cars, motorbikes or motorhomes. No phone numbers. Use residential proxy DE on HTTP 403.", "version": "0.1", "x-build-id": "58Vfxtm2N4h6vFB4z" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/noahadler~autoscout24-nutzfahrzeuge/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-noahadler-autoscout24-nutzfahrzeuge", "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-nutzfahrzeuge/runs": { "post": { "operationId": "runs-sync-noahadler-autoscout24-nutzfahrzeuge", "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-nutzfahrzeuge/run-sync": { "post": { "operationId": "run-sync-noahadler-autoscout24-nutzfahrzeuge", "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. Ford, Volkswagen, Renault). Combined with model when query is empty." }, "model": { "title": "Model", "type": "string", "description": "Model (e.g. Transit, Caddy, Kangoo)." }, "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.", "default": [], "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.", "default": [], "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 Nutzfahrzeug listings to collect (1-200). About 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 } } } } } } } } } }