{
  "openapi": "3.0.1",
  "info": {
    "title": "Autotrader Australia Scraper",
    "description": "[💰 $0.9 / 1K] Extract new and used car listings from Autotrader.com.au — price, odometer, year, make/model, body, fuel, transmission, drive type, dealer contacts, location, and photos. Search by make, model, state, condition, price and year, or paste any Autotrader URL.",
    "version": "1.0",
    "x-build-id": "JYwrqWT5ahDlLB26K"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/solidcode~autotrader-com-au-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-solidcode-autotrader-com-au-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~autotrader-com-au-scraper/runs": {
      "post": {
        "operationId": "runs-sync-solidcode-autotrader-com-au-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~autotrader-com-au-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-solidcode-autotrader-com-au-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": "Autotrader URLs",
            "type": "array",
            "description": "Paste Autotrader.com.au search result URLs or individual car listing URLs (for example 'https://www.autotrader.com.au/for-sale/toyota/hilux' or a single car's page). When you provide URLs here, the search options below are ignored.",
            "items": {
              "type": "string"
            }
          },
          "make": {
            "title": "Make",
            "type": "string",
            "description": "Car manufacturer, for example 'Toyota', 'Ford', 'Mazda' or 'Hyundai'. Leave empty to include every make."
          },
          "model": {
            "title": "Model",
            "type": "string",
            "description": "Model name, for example 'HiLux', 'Ranger' or 'Corolla'. Must belong to the make you chose above. Leave empty to include every model."
          },
          "state": {
            "title": "State or Territory",
            "enum": [
              "any",
              "nsw",
              "vic",
              "qld",
              "wa",
              "sa",
              "tas",
              "act",
              "nt"
            ],
            "type": "string",
            "description": "Limit results to one Australian state or territory. Choose 'Anywhere in Australia' to search the whole country."
          },
          "city": {
            "title": "City or Suburb",
            "type": "string",
            "description": "Exact suburb name, for example 'Melbourne', 'Richmond' or 'Underwood'. This matches the suburb the car is listed in — it is not a radius search, so a big-city name returns only cars in that exact suburb, not the surrounding area. Leave empty to search the whole state."
          },
          "condition": {
            "title": "Condition",
            "enum": [
              "any",
              "new",
              "used",
              "demo",
              "certified"
            ],
            "type": "string",
            "description": "Only include cars in this condition. Note that 'Certified pre-owned' is a small, specialist pool of cars — combining it with other filters often returns nothing."
          },
          "bodyType": {
            "title": "Body Type",
            "uniqueItems": true,
            "type": "array",
            "description": "Only include these body shapes. Leave empty to include every body type.",
            "items": {
              "type": "string",
              "enum": [
                "suv",
                "sedan",
                "hatchback",
                "wagon",
                "coupe",
                "convertible",
                "ute-tray",
                "people-mover",
                "van"
              ],
              "enumTitles": [
                "SUV",
                "Sedan",
                "Hatchback",
                "Wagon",
                "Coupe",
                "Convertible",
                "Ute / Tray",
                "People mover",
                "Van"
              ]
            }
          },
          "fuelType": {
            "title": "Fuel Type",
            "uniqueItems": true,
            "type": "array",
            "description": "Only include cars running on these fuels. Leave empty to include every fuel type.",
            "items": {
              "type": "string",
              "enum": [
                "diesel",
                "unleaded",
                "premium",
                "hybrid",
                "electric",
                "lpg",
                "leaded"
              ],
              "enumTitles": [
                "Diesel",
                "Unleaded",
                "Premium unleaded",
                "Hybrid",
                "Electric",
                "LPG",
                "Leaded"
              ]
            }
          },
          "transmission": {
            "title": "Transmission",
            "enum": [
              "any",
              "automatic",
              "manual"
            ],
            "type": "string",
            "description": "Gearbox type."
          },
          "driveType": {
            "title": "Drive Type",
            "enum": [
              "any",
              "front-wheel-drive",
              "rear-wheel-drive",
              "four-wheel-drive",
              "all-wheel-drive"
            ],
            "type": "string",
            "description": "Which wheels the car drives."
          },
          "priceMin": {
            "title": "Minimum Price (AUD)",
            "minimum": 0,
            "maximum": 5000000,
            "type": "integer",
            "description": "Only include cars at or above this advertised price in Australian dollars. Leave empty for no lower limit."
          },
          "priceMax": {
            "title": "Maximum Price (AUD)",
            "minimum": 0,
            "maximum": 5000000,
            "type": "integer",
            "description": "Only include cars at or below this advertised price in Australian dollars. Leave empty for no upper limit."
          },
          "yearMin": {
            "title": "Earliest Year",
            "minimum": 1900,
            "maximum": 2030,
            "type": "integer",
            "description": "Only include cars from this year onwards, for example 2018. Leave empty to include cars of any age."
          },
          "yearMax": {
            "title": "Latest Year",
            "minimum": 1900,
            "maximum": 2030,
            "type": "integer",
            "description": "Only include cars up to and including this year. Leave empty to include cars of any age."
          },
          "sortBy": {
            "title": "Sort Results By",
            "enum": [
              "relevance",
              "price-asc",
              "price-desc",
              "newest",
              "year-desc",
              "year-asc",
              "odometer-asc",
              "odometer-desc"
            ],
            "type": "string",
            "description": "The order cars come back in. This decides which cars you get when you limit the number of results — 'Price: lowest first' with 20 results gives you the 20 cheapest matches, instead of 20 taken from anywhere in the list."
          },
          "includeListingDetails": {
            "title": "Include full listing details",
            "type": "boolean",
            "description": "Adds the seller's full description, the itemised feature list, and the dealer's street address to every car. Everything else — specifications, VIN, stock number, every photo, price, dealer name and phone — is included either way, so turning this off still gives you a rich row and makes the run noticeably faster."
          },
          "maxResults": {
            "title": "Maximum Results",
            "minimum": 0,
            "maximum": 50000,
            "type": "integer",
            "description": "Largest number of cars to return per search. You get exactly this many (or fewer, if the search has fewer matches) — results are collected in batches of up to 50, sized down automatically near the end so you're never charged for extra cars. If you paste several search addresses, each one collects up to this many, so the total can be higher; individual car pages share one limit between them. Set to 0 to collect everything available, up to a safety limit of 50,000 cars."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}