{
  "openapi": "3.0.1",
  "info": {
    "title": "Carsales.com.au Scraper",
    "description": "Extract car listings from carsales.com.au with 14 search filters including colour, cylinders, odometer range, postcode radius and sort order. 40+ fields per listing. $1.50/1k.",
    "version": "0.0",
    "x-build-id": "rdubIgeWUKlM60otr"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/unfenced-group~carsales-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-unfenced-group-carsales-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/unfenced-group~carsales-scraper/runs": {
      "post": {
        "operationId": "runs-sync-unfenced-group-carsales-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/unfenced-group~carsales-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-unfenced-group-carsales-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": "Start URLs",
            "type": "array",
            "description": "One or more carsales.com.au search URLs. Paste the URL from your browser after applying all filters on the site. If provided, all filter fields below are ignored.",
            "default": [],
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "condition": {
            "title": "Vehicle condition",
            "enum": [
              "all",
              "used",
              "new",
              "demo"
            ],
            "type": "string",
            "description": "Filter by vehicle condition.",
            "default": "all"
          },
          "make": {
            "title": "Car brand (make)",
            "type": "string",
            "description": "Car make/brand to filter by (e.g. Toyota, BMW, Ford). Leave empty for all makes.",
            "default": ""
          },
          "model": {
            "title": "Car model",
            "type": "string",
            "description": "Car model to filter by (e.g. Hilux, Camry). Requires Make to be set.",
            "default": ""
          },
          "state": {
            "title": "State",
            "enum": [
              "",
              "NSW",
              "VIC",
              "QLD",
              "SA",
              "WA",
              "TAS",
              "ACT",
              "NT"
            ],
            "type": "string",
            "description": "Australian state or territory to filter by.",
            "default": ""
          },
          "bodyStyle": {
            "title": "Body style",
            "enum": [
              "",
              "SUV",
              "Sedan",
              "Hatchback",
              "Ute",
              "Van",
              "Wagon",
              "Coupe",
              "Convertible",
              "People Mover"
            ],
            "type": "string",
            "description": "Vehicle body style to filter by.",
            "default": ""
          },
          "fuelType": {
            "title": "Fuel type",
            "enum": [
              "",
              "Petrol",
              "Diesel",
              "Hybrid",
              "Electric",
              "Plug-in Hybrid",
              "LPG"
            ],
            "type": "string",
            "description": "Fuel type to filter by.",
            "default": ""
          },
          "transmission": {
            "title": "Transmission type",
            "enum": [
              "",
              "Automatic",
              "Manual"
            ],
            "type": "string",
            "description": "Transmission type to filter by.",
            "default": ""
          },
          "colour": {
            "title": "Colour",
            "enum": [
              "",
              "Black",
              "White",
              "Silver",
              "Grey",
              "Blue",
              "Red",
              "Green",
              "Brown",
              "Orange",
              "Yellow",
              "Gold",
              "Purple"
            ],
            "type": "string",
            "description": "Exterior colour to filter by.",
            "default": ""
          },
          "cylinders": {
            "title": "Cylinders",
            "enum": [
              "0",
              "3",
              "4",
              "6",
              "8",
              "10",
              "12"
            ],
            "type": "string",
            "description": "Number of engine cylinders to filter by.",
            "default": "0"
          },
          "doors": {
            "title": "Doors",
            "enum": [
              "0",
              "2",
              "3",
              "4",
              "5"
            ],
            "type": "string",
            "description": "Number of doors to filter by.",
            "default": "0"
          },
          "sellerType": {
            "title": "Seller type",
            "enum": [
              "all",
              "dealer",
              "private"
            ],
            "type": "string",
            "description": "Filter by seller type.",
            "default": "all"
          },
          "minPrice": {
            "title": "Min price (AUD)",
            "minimum": 0,
            "type": "integer",
            "description": "Minimum listing price in Australian dollars. Leave blank for no minimum."
          },
          "maxPrice": {
            "title": "Max price (AUD)",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum listing price in Australian dollars. Leave blank for no maximum."
          },
          "minYear": {
            "title": "Min year",
            "minimum": 1900,
            "type": "integer",
            "description": "Oldest model year to include. Leave blank for no minimum."
          },
          "maxYear": {
            "title": "Max year",
            "minimum": 1900,
            "type": "integer",
            "description": "Newest model year to include. Leave blank for no maximum."
          },
          "minOdometer": {
            "title": "Min odometer (km)",
            "minimum": 0,
            "type": "integer",
            "description": "Minimum odometer reading in kilometres. Leave blank for no minimum."
          },
          "maxOdometer": {
            "title": "Max odometer (km)",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum odometer reading in kilometres. Leave blank for no maximum."
          },
          "postcode": {
            "title": "Postcode",
            "type": "string",
            "description": "Currently not supported: carsales no longer applies postcode search, so this field is ignored.",
            "default": ""
          },
          "radius": {
            "title": "Search radius (km)",
            "minimum": 0,
            "type": "integer",
            "description": "Currently not supported: ignored together with Postcode."
          },
          "sortBy": {
            "title": "Sort order",
            "enum": [
              "featured",
              "price-asc",
              "price-desc",
              "year-desc",
              "year-asc",
              "odometer-asc",
              "newest"
            ],
            "type": "string",
            "description": "Order in which to return listings. Price and odometer sorts cover all results in that order. Featured and newest return their first page in that order and continue in price order.",
            "default": "featured"
          },
          "fetchDetails": {
            "title": "Fetch full listing details",
            "type": "boolean",
            "description": "Fetch full description, features list, VIN, ANCAP rating, and dealer phone from each listing's detail page. Slower and uses more proxy bandwidth.",
            "default": false
          },
          "skipReposts": {
            "title": "Skip reposts",
            "type": "boolean",
            "description": "Skip listings already seen in previous runs. Uses a 90-day deduplication cache. Ideal for daily scheduled runs.",
            "default": false
          },
          "requestDelayMs": {
            "title": "Request delay (ms)",
            "minimum": 500,
            "type": "integer",
            "description": "Minimum delay between page requests in milliseconds. Increase to reduce load on the server.",
            "default": 1500
          },
          "maxItems": {
            "title": "Max results",
            "minimum": 1,
            "type": "integer",
            "description": "Maximum number of listings to return. Each listing counts as one result for billing.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}