{
  "openapi": "3.0.1",
  "info": {
    "title": "Bilbasen.dk Scraper",
    "description": "[💰 $1.5 / 1K] Extract new and used car listings from Bilbasen.dk, Denmark's largest car marketplace — price, mileage, year, specs (horsepower, fuel, gearbox, EV range & battery, tax), location, photos, and optional monthly finance price. Search by make/model + filters, postal code, or any URL.",
    "version": "1.0",
    "x-build-id": "u01kbVu4FGl3DOWMt"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/solidcode~bilbasen-dk-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-solidcode-bilbasen-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/solidcode~bilbasen-dk-scraper/runs": {
      "post": {
        "operationId": "runs-sync-solidcode-bilbasen-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/solidcode~bilbasen-dk-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-solidcode-bilbasen-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",
        "properties": {
          "startUrls": {
            "title": "Bilbasen URLs",
            "type": "array",
            "description": "Paste one or more Bilbasen.dk search-result URLs or individual car-listing URLs (e.g. 'https://www.bilbasen.dk/brugt/bil/audi/a4' or a single car page). Go to bilbasen.dk, set your filters in the browser, and copy the URL from the address bar. When provided, these are used directly and the search fields below are ignored.",
            "items": {
              "type": "string"
            }
          },
          "make": {
            "title": "Make",
            "type": "string",
            "description": "Car manufacturer as shown on Bilbasen, e.g. 'Audi', 'Volkswagen', 'Tesla'. Leave empty for all makes. Ignored when Bilbasen URLs are provided."
          },
          "model": {
            "title": "Model",
            "type": "string",
            "description": "Model name as shown on Bilbasen (must match the chosen Make), e.g. 'A4', 'Golf', 'Model 3'. Leave empty for all models of the chosen make."
          },
          "fuelType": {
            "title": "Fuel type",
            "uniqueItems": true,
            "type": "array",
            "description": "Only include cars with these fuel types. Leave empty for all fuel types.",
            "items": {
              "type": "string",
              "enum": [
                "benzin",
                "diesel",
                "el",
                "hybrid-benzin",
                "hybrid-diesel",
                "plugin-hybrid-benzin",
                "plugin-hybrid-diesel"
              ],
              "enumTitles": [
                "Petrol (Benzin)",
                "Diesel",
                "Electric (El)",
                "Hybrid – Petrol",
                "Hybrid – Diesel",
                "Plug-in Hybrid – Petrol",
                "Plug-in Hybrid – Diesel"
              ]
            }
          },
          "bodyType": {
            "title": "Body type",
            "uniqueItems": true,
            "type": "array",
            "description": "Only include cars with these body types. Leave empty for all body types. Note: selecting 'Van' searches the separate van category and is best used on its own.",
            "items": {
              "type": "string",
              "enum": [
                "micro",
                "hatchback",
                "sedan",
                "stationcar",
                "suv",
                "cuv",
                "mpv",
                "coupe",
                "cabriolet",
                "van"
              ],
              "enumTitles": [
                "Micro",
                "Hatchback",
                "Sedan",
                "Station wagon (Stationcar)",
                "SUV",
                "Crossover (CUV)",
                "MPV / Minivan",
                "Coupé",
                "Convertible (Cabriolet)",
                "Van"
              ]
            }
          },
          "gearType": {
            "title": "Transmission",
            "enum": [
              "any",
              "manuel",
              "automatisk"
            ],
            "type": "string",
            "description": "Gearbox type.",
            "default": "any"
          },
          "sellerType": {
            "title": "Seller type",
            "enum": [
              "any",
              "dealer",
              "private"
            ],
            "type": "string",
            "description": "Filter listings by who is selling.",
            "default": "any"
          },
          "priceType": {
            "title": "Price type",
            "enum": [
              "any",
              "retail",
              "leasing"
            ],
            "type": "string",
            "description": "Which kind of price to filter on. 'Retail' is a normal cash purchase, 'Leasing' is a monthly lease offer.",
            "default": "any"
          },
          "priceMin": {
            "title": "Minimum price (DKK)",
            "minimum": 0,
            "maximum": 20000000,
            "type": "integer",
            "description": "Only include cars at or above this price, in Danish kroner. Leave empty for no lower bound."
          },
          "priceMax": {
            "title": "Maximum price (DKK)",
            "minimum": 0,
            "maximum": 20000000,
            "type": "integer",
            "description": "Only include cars at or below this price, in Danish kroner. Leave empty for no upper bound."
          },
          "yearMin": {
            "title": "Minimum year",
            "minimum": 1900,
            "maximum": 2030,
            "type": "integer",
            "description": "Only include cars first registered in or after this year, e.g. 2018. Leave empty for any age."
          },
          "yearMax": {
            "title": "Maximum year",
            "minimum": 1900,
            "maximum": 2030,
            "type": "integer",
            "description": "Only include cars first registered in or before this year. Leave empty for any age."
          },
          "mileageMax": {
            "title": "Maximum mileage (km)",
            "minimum": 0,
            "maximum": 2000000,
            "type": "integer",
            "description": "Only include cars with at most this many kilometers on the odometer, e.g. 100000. Leave empty for any mileage."
          },
          "zipCode": {
            "title": "Postal code",
            "type": "string",
            "description": "Danish postal code to search around, e.g. '2100' (Copenhagen) or '8000' (Aarhus). Used together with Search radius. Leave empty to search all of Denmark."
          },
          "radiusKm": {
            "title": "Search radius (km)",
            "enum": [
              "10",
              "25",
              "50",
              "100",
              "150",
              "200"
            ],
            "type": "string",
            "description": "How far around the postal code to search, in kilometers. Only applies when a postal code is set.",
            "default": "100"
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "relevance",
              "priceAsc",
              "priceDesc",
              "yearDesc",
              "yearAsc",
              "mileageAsc",
              "newest"
            ],
            "type": "string",
            "description": "How to order the search results. Defaults to Bilbasen's relevance ranking.",
            "default": "relevance"
          },
          "includeFinancing": {
            "title": "Include monthly finance price",
            "type": "boolean",
            "description": "When enabled, every car is also looked up against Bilbasen's financing calculator to add the lowest available monthly finance instalment (monthlyPrice) to each row. This adds an extra lookup per car, so the run takes a little longer. Leave off for the fastest run.",
            "default": false
          },
          "maxResults": {
            "title": "Maximum results",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "Maximum number of car listings to return per search or URL. The actor may return a few extra from the final page — it stops requesting new pages once the cap is reached. Set to 0 for unlimited (subject to Bilbasen's pagination ceiling).",
            "default": 100
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}