{ "openapi": "3.0.1", "info": { "title": "DBA.dk Scraper", "description": "Scrape DBA.dk - Denmark's largest online marketplace for used and new items. Search by keyword, browse by category, search cars, or fetch full listing details by item ID/URL. Get prices, images, condition, location, seller type and more - no login required.", "version": "1.0", "x-build-id": "1V5oB0M7nYhTfvcFF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~dba-dk-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-dba-dk-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/crawlerbros~dba-dk-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-dba-dk-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/crawlerbros~dba-dk-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-dba-dk-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "browseCategory", "itemDetail", "sellerListings", "carSearch" ], "type": "string", "description": "What to fetch.", "default": "search" }, "searchQuery": { "title": "Search query", "type": "string", "description": "Free-text keyword search. For `mode=search`, e.g. `cykel`, `sofa`, `iphone`. For `mode=carSearch`, matches car make/model/free text, e.g. `Golf`, `Tesla`.", "default": "cykel" }, "category": { "title": "Category", "enum": [ "", "0.90", "0.77", "0.93", "0.91", "0.68", "0.67", "0.76", "0.71", "0.78", "0.69", "0.86" ], "type": "string", "description": "Top-level marketplace category (mode=browseCategory, required; optional filter for mode=search).", "default": "" }, "subCategory": { "title": "Sub-category code", "type": "string", "description": "Narrower DBA.dk sub-category code (e.g. `1.90.82` for car accessories & parts). Find codes by browsing a top-level category on dba.dk and copying the `sub_category` value from the URL. Optional filter for `search`/`browseCategory`; combine with `category` for best results.", "default": "" }, "productCategory": { "title": "Product-category code", "type": "string", "description": "Most specific DBA.dk product-category code (e.g. `2.90.82.4` for roof racks & boxes). Find codes by browsing dba.dk and copying the `product_category` value from the URL. Optional filter for `search`/`browseCategory`.", "default": "" }, "sortBy": { "title": "Sort by", "enum": [ "RELEVANCE", "PUBLISHED_DESC", "PUBLISHED_ASC", "PRICE_DESC", "PRICE_ASC" ], "type": "string", "description": "Result ordering. Applies to `search`, `browseCategory` and `carSearch`.", "default": "RELEVANCE" }, "location": { "title": "Region", "enum": [ "", "0.200001", "0.200002", "0.200003", "0.200004", "0.200005", "0.200006", "0.200007", "0.200008", "0.200009", "0.200010", "0.200011", "0.200012" ], "type": "string", "description": "Limit results to a Danish region. Applies to `search`, `browseCategory` and `carSearch`.", "default": "" }, "subLocation": { "title": "City/town location code", "type": "string", "description": "Narrower DBA.dk city/town location code (e.g. `1.200010.213700` for Rønne). Find codes by browsing dba.dk with a region selected and copying the `location` value from the URL for a specific city. Optional filter for `search`/`browseCategory`; combine with `location` for best results.", "default": "" }, "condition": { "title": "Condition", "enum": [ "", "1", "2", "3", "4", "5" ], "type": "string", "description": "Item condition filter.", "default": "" }, "tradeType": { "title": "Listing type", "enum": [ "", "1", "2", "3" ], "type": "string", "description": "Type of listing.", "default": "" }, "dealerSegment": { "title": "Seller type", "enum": [ "", "1", "3" ], "type": "string", "description": "Filter by private seller or professional dealer.", "default": "" }, "shippingType": { "title": "Shipping", "enum": [ "", "0", "1" ], "type": "string", "description": "Filter by delivery option.", "default": "" }, "boundingBox": { "title": "Map bounding box (mode=search/browseCategory)", "type": "string", "description": "Restrict results to a rectangular map area, as `minLon,minLat,maxLon,maxLat` (e.g. `12.4,55.6,12.7,55.8` covers central Copenhagen). Get coordinates from Google Maps or a bounding-box tool. Works for `search`/`browseCategory`/`carSearch`. Can be used alone (no `searchQuery`/`category` needed) or combined with any other filter.", "default": "" }, "publishedToday": { "title": "New today only", "type": "boolean", "description": "Only include listings/cars that were published today. Applies to `search`, `browseCategory` and `carSearch`.", "default": false }, "brandQuery": { "title": "Brand contains", "type": "string", "description": "Only keep listings whose extracted `brand` contains this text (case-insensitive), e.g. `Giant`, `Ikea`, `Apple`.", "default": "" }, "priceMin": { "title": "Min price (DKK)", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Drop listings/cars priced below this amount (Danish kroner). Applies to all search modes." }, "priceMax": { "title": "Max price (DKK)", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Drop listings/cars priced above this amount (Danish kroner). Applies to all search modes." }, "itemIds": { "title": "Item IDs or URLs (mode=itemDetail)", "type": "array", "description": "DBA.dk listing IDs (e.g. `20578076`) or full listing URLs.", "default": [], "items": { "type": "string" } }, "shopSlug": { "title": "Shop slug or URL (mode=sellerListings)", "type": "string", "description": "A DBA.dk dealer shop slug (e.g. `bike4sport`) or full shop URL (e.g. `https://www.dba.dk/shop/bike4sport`). Find it by opening a dealer listing and clicking through to their shop page.", "default": "" }, "vehicleType": { "title": "Vehicle type (mode=carSearch)", "enum": [ "car", "motorcycle", "boat", "caravan", "motorhome", "atv", "scooter" ], "type": "string", "description": "Which DBA.dk mobility-marketplace vertical to search. Each has its own filter nuances — `yearMin`/`yearMax`/`mileageMax`/`bodyType`/`wheelDrive`/`registrationClass` are most meaningful for cars/caravans/motorhomes; boats, motorcycles, ATVs and scooters instead expose fields like `motorPowerHp`, `boatClass` or `engineVolumeCc` in the output.", "default": "car" }, "carVariant": { "title": "Car make/model code (mode=carSearch)", "type": "string", "description": "DBA.dk car-marketplace make/model code (e.g. `0.813` for all Toyota, `1.8093.2476` for Abarth 500-series). Find codes by browsing `dba.dk/mobility/search/car` and copying the `variant` value from the URL after picking a make/model. Optional filter for `carSearch`; combine with `searchQuery` for best results.", "default": "" }, "yearMin": { "title": "Min model year (mode=carSearch)", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Drop cars first registered before this year." }, "yearMax": { "title": "Max model year (mode=carSearch)", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Drop cars first registered after this year." }, "mileageMax": { "title": "Max mileage, km (mode=carSearch)", "minimum": 0, "maximum": 2000000, "type": "integer", "description": "Drop cars with more kilometres on the odometer than this." }, "fuelType": { "title": "Fuel type (mode=carSearch)", "enum": [ "", "1", "2", "4", "3", "5", "6", "8", "1352" ], "type": "string", "description": "Filter cars by fuel type.", "default": "" }, "transmissionType": { "title": "Transmission (mode=carSearch)", "enum": [ "", "1", "2" ], "type": "string", "description": "Filter cars by gearbox type.", "default": "" }, "bodyType": { "title": "Body type (mode=carSearch)", "enum": [ "", "1", "2", "3", "4", "9", "5", "6", "7", "8", "1637", "10", "11" ], "type": "string", "description": "Filter cars by body style.", "default": "" }, "wheelDrive": { "title": "Drivetrain (mode=carSearch)", "enum": [ "", "3", "1", "2" ], "type": "string", "description": "Filter cars by drivetrain.", "default": "" }, "carDealerSegment": { "title": "Seller type (mode=carSearch)", "enum": [ "", "2", "3" ], "type": "string", "description": "Filter cars by private seller or professional dealer. Uses a different value mapping than the general `Seller type` filter, so it's a separate option.", "default": "" }, "registrationClass": { "title": "Registration class (mode=carSearch)", "enum": [ "", "1", "8", "2" ], "type": "string", "description": "Filter cars by vehicle registration class.", "default": "" }, "exteriorColour": { "title": "Exterior colour (mode=carSearch)", "enum": [ "", "1", "2", "3", "4", "6", "5", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16" ], "type": "string", "description": "Filter cars by exterior colour.", "default": "" }, "engineEffectMin": { "title": "Min horsepower (mode=carSearch)", "minimum": 0, "maximum": 2000, "type": "integer", "description": "Drop cars with less engine power than this, in hp." }, "engineEffectMax": { "title": "Max horsepower (mode=carSearch)", "minimum": 0, "maximum": 2000, "type": "integer", "description": "Drop cars with more engine power than this, in hp." }, "carEquipment": { "title": "Equipment (mode=carSearch)", "enum": [ "", "9", "23", "1588", "67", "70", "73", "11", "12", "35", "49", "1" ], "type": "string", "description": "Only include cars with this equipment feature.", "default": "" }, "warrantyInsurance": { "title": "Warranty (mode=carSearch)", "enum": [ "", "1" ], "type": "string", "description": "Only include cars sold with a warranty.", "default": "" }, "carCondition": { "title": "Service history (mode=carSearch)", "enum": [ "", "1" ], "type": "string", "description": "Only include cars with a documented service history.", "default": "" }, "wheelSets": { "title": "Wheel sets (mode=carSearch)", "enum": [ "", "1", "2" ], "type": "string", "description": "Filter cars by how many wheel sets (e.g. summer + winter tyres) are included.", "default": "" }, "trailerWeightMin": { "title": "Min allowed trailer weight, kg (mode=carSearch)", "minimum": 0, "maximum": 4000, "type": "integer", "description": "Drop cars with a lower permitted towing/trailer weight than this, in kg." }, "trailerWeightMax": { "title": "Max allowed trailer weight, kg (mode=carSearch)", "minimum": 0, "maximum": 4000, "type": "integer", "description": "Drop cars with a higher permitted towing/trailer weight than this, in kg." }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on emitted records.", "default": 50 } } }, "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 } } } } } } } } } }