{ "openapi": "3.0.1", "info": { "title": "TruckScout24 Scraper — Used Trucks, Trailers & Machinery", "description": "Scrape TruckScout24 used trucks, tractor units, trailers, vans, buses and construction or farm machinery across Europe: net and gross price, make, model, mileage or hours, power, first registration, emission class, location, country, images, full technical data. By category, make or URL. No login.", "version": "0.1", "x-build-id": "SR1F8ASqSYuxfIw9W" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/yugenox~truckscout24-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-yugenox-truckscout24-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/yugenox~truckscout24-scraper/runs": { "post": { "operationId": "runs-sync-yugenox-truckscout24-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/yugenox~truckscout24-scraper/run-sync": { "post": { "operationId": "run-sync-yugenox-truckscout24-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": { "categories": { "title": "🚛 Categories", "type": "array", "description": "TruckScout24 categories to scrape. Combine with makes below, e.g. Tractor units + \"Volvo\".", "items": { "type": "string", "enum": [ "trucks", "tractor-units", "semi-trailers", "trailers", "vans", "buses", "construction-machines", "agricultural-machines", "forklifts", "campervans-motorhomes-caravans", "special-vehicles", "excavators", "loaders", "cranes", "work-platforms" ], "enumTitles": [ "Trucks", "Tractor units", "Semi-trailers", "Trailers", "Vans (up to 7.5 t)", "Buses & coaches", "Construction machines", "Agricultural machines", "Forklifts", "Campervans, motorhomes & caravans", "Special & municipal vehicles", "Excavators", "Loaders", "Cranes", "Work platforms" ] } }, "makes": { "title": "🏷️ Makes", "type": "array", "description": "Optional: manufacturers, e.g. \"Mercedes-Benz\", \"MAN\", \"Volvo\", \"Scania\", \"DAF\", \"Iveco\". Each make is searched in each category above (Excavators, Loaders, Cranes and Work platforms are searched whole). A make TruckScout24 doesn't know is skipped and not charged.", "items": { "type": "string" } }, "startUrls": { "title": "🔗 TruckScout24 URLs", "type": "array", "description": "Optional: any truckscout24.com category, subcategory or make page (e.g. truckscout24.com/trucks/used/box/mercedes-benz or truckscout24.com/Excavators/ts-cat-105), or listing pages (truckscout24.com/tsp/ts-228-61-715). Listing URLs always return full details.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max listings", "minimum": 0, "maximum": 20000, "type": "integer", "description": "Maximum number of listings for the whole run, shared fairly between your searches (a search that finds fewer leaves its share to the others). 0 = everything.", "default": 100 }, "includeDetails": { "title": "Include full details", "type": "boolean", "description": "Also open every listing page for the complete technical data (dimensions, weights, axles, cab, equipment …), the full description, all gallery images, the seller's reference number, the last update date and how long the seller has been on TruckScout24. The listing cards already have price, make, model, mileage, power, first registration, emission class and location.", "default": false }, "splitLargeCategories": { "title": "Go past 200 listings per category", "type": "boolean", "description": "TruckScout24 shows at most 200 listings for one category page. When you want more, the scraper goes through the category's subcategories one by one (each counts as a search).", "default": true }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy (datacenter) is the default and comes with every Apify plan. If TruckScout24 refuses datacenter IPs for a while, the run switches to residential proxies when your account has them.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }