{
  "openapi": "3.0.1",
  "info": {
    "title": "Chileautos.cl Scraper - Cars, Prices & Specs from Chile",
    "description": "Scrape car listings from chileautos.cl, Chile's largest car marketplace: prices, year, mileage, specs, dealers, regions and images. Fast HTTP-only scraper with no 900-result limit.",
    "version": "0.2",
    "x-build-id": "VDSHaIG7RiydaR5zj"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/rastriq~chileautos-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-rastriq-chileautos-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/rastriq~chileautos-scraper/runs": {
      "post": {
        "operationId": "runs-sync-rastriq-chileautos-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/rastriq~chileautos-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-rastriq-chileautos-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": {
          "urls": {
            "title": "🔗 URLs or listing IDs",
            "type": "array",
            "description": "<b>Paste one or more chileautos.cl links — or bare listing IDs.</b><br><br>Supported:<br>• <b>Search pages</b>, as they appear in your browser — e.g. <code>https://www.chileautos.cl/vehiculos/autos-vehículo/toyota/hilux/</code> or with filter segments like <code>/suv-carroceria/</code>, <code>/usado-tipo/</code>, <code>/ohiggins-región/</code><br>• <b>Search URLs with a query</b> — <code>…/vehiculos/?q=(And.…)</code><br>• <b>Listing pages</b> — <code>…/vehiculos/detalles/…/CL-AD-20899780/</code> → that listing with full details<br>• <b>Listing IDs</b> — <code>CL-AD-20899780</code>, <code>GI-AD-930739</code><br><br>When URLs are set, the search filters below are ignored (except <b>Dealer IDs</b>).",
            "items": {
              "type": "string"
            }
          },
          "make": {
            "title": "🚗 Make (brand)",
            "type": "string",
            "description": "<b>Brand exactly as written on chileautos.cl.</b> Examples: <code>Toyota</code>, <code>Hyundai</code>, <code>Mercedes-Benz</code>, <code>Land Rover</code>.<br>Several brands separated by commas are combined with OR: <code>Toyota, Kia, Hyundai</code>.<br>Leave empty for all brands.<br><br>⚠️ The site returns <b>0 results — not an error —</b> for a misspelled brand. The run log warns you when that happens."
          },
          "model": {
            "title": "Model",
            "type": "string",
            "description": "Model within the make. Examples: <code>Hilux</code>, <code>Corolla</code>, <code>Tucson</code>, <code>Sportage</code>.<br>Requires exactly one make. Leave empty for every model of that brand."
          },
          "condition": {
            "title": "🏷️ Condition",
            "enum": [
              "Usado",
              "Nuevo"
            ],
            "type": "string",
            "description": "Used or new vehicles. Leave unset for both."
          },
          "bodyType": {
            "title": "🚙 Body type",
            "enum": [
              "SUV",
              "Sedán",
              "Hatchback",
              "Pick up",
              "Station Wagon",
              "Coupé",
              "Convertible",
              "Van",
              "Furgón",
              "Minivan"
            ],
            "type": "string",
            "description": "Body style as categorized by chileautos.cl. Pick-ups are listed here, not as a separate vehicle type."
          },
          "fuel": {
            "title": "⛽ Fuel type",
            "enum": [
              "Bencina",
              "Diesel",
              "Híbrido",
              "Eléctrico",
              "Gas"
            ],
            "type": "string",
            "description": "Filter by fuel type. Leave unset to include all."
          },
          "gearbox": {
            "title": "⚙️ Gearbox",
            "enum": [
              "Automática",
              "Manual"
            ],
            "type": "string",
            "description": "Filter by transmission type."
          },
          "minPrice": {
            "title": "💰 Min price (CLP)",
            "minimum": 0,
            "type": "integer",
            "description": "Only listings priced at or above this amount, in Chilean pesos. Example: <code>10000000</code> = $10M CLP."
          },
          "maxPrice": {
            "title": "💰 Max price (CLP)",
            "minimum": 0,
            "type": "integer",
            "description": "Only listings priced at or below this amount, in Chilean pesos."
          },
          "minYear": {
            "title": "📅 Min year",
            "minimum": 1950,
            "maximum": 2030,
            "type": "integer",
            "description": "Oldest model year to include."
          },
          "maxYear": {
            "title": "📅 Max year",
            "minimum": 1950,
            "maximum": 2030,
            "type": "integer",
            "description": "Newest model year to include."
          },
          "minKm": {
            "title": "🛣️ Min mileage (km)",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest odometer reading to include."
          },
          "maxKm": {
            "title": "🛣️ Max mileage (km)",
            "minimum": 0,
            "type": "integer",
            "description": "Highest odometer reading to include. Example: <code>50000</code> for low-mileage cars."
          },
          "sellerType": {
            "title": "👤 Seller type",
            "enum": [
              "Agencia",
              "Particular",
              "Particular Verificado"
            ],
            "type": "string",
            "description": "<b>Dealers or private sellers.</b><br>With incremental mode, give each seller type its own <b>Stream id</b> if you want independent dealer and private streams."
          },
          "vehicleType": {
            "title": "🏍️ Vehicle type",
            "enum": [
              "Autos",
              "Motos"
            ],
            "type": "string",
            "description": "Leave unset for cars (the default on chileautos.cl). Choose <b>Motos</b> for motorcycles."
          },
          "region": {
            "title": "📍 Region",
            "enum": [
              "Arica y Parinacota",
              "Tarapacá",
              "Antofagasta",
              "Atacama",
              "Coquimbo",
              "Valparaíso",
              "Metropolitana de Santiago",
              "OHiggins",
              "Maule",
              "Ñuble",
              "Bío Bío",
              "Araucanía",
              "Los Ríos",
              "Los Lagos",
              "Aysén",
              "Magallanes y Antártica Chilena"
            ],
            "type": "string",
            "description": "Chilean region where the vehicle is located. Useful for sharding a national extraction: each region is an independent slice."
          },
          "dealerIds": {
            "title": "🏪 Dealer IDs",
            "type": "array",
            "description": "<b>Scrape the full stock of specific dealers.</b> Example: <code>CL-SELLER-1428</code>.<br>You get each dealer's ID in <code>seller.id</code> when <b>Include full listing details</b> is on. Combined with the search filters above, e.g. one dealer's SUVs only.",
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "📊 Max results",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "<b>Hard cap on the number of listings returned.</b><br>The default of <b>50</b> finishes in seconds. A whole brand (~2,500 listings) takes under a minute; the entire marketplace (~62,000) about 20 minutes.<br>Set <b>0</b> for no limit. Chileautos only lets a search reach 900 results; above that the actor splits the search by price automatically, so you still get everything, without duplicates.",
            "default": 50
          },
          "includeDetails": {
            "title": "📋 Include full listing details",
            "type": "boolean",
            "description": "<b>Adds the full spec sheet and seller block.</b> ~60 specifications (engine cc, power, torque, traction, doors, seats, dimensions, safety equipment…), exterior and interior color, commune, seller description, dealer profile and the financing simulation.<br>One extra request per listing, billed as the <b>details add-on</b> event.",
            "default": false
          },
          "includeAllImages": {
            "title": "🖼️ Include all images",
            "type": "boolean",
            "description": "Search results carry up to 5 images per listing. Enable to fetch the complete gallery (16–40 photos is common for dealers). One extra request per listing that has more than 5 photos. No extra charge.",
            "default": false
          },
          "enableCursor": {
            "title": "🔄 Incremental mode (delta engine)",
            "type": "boolean",
            "description": "<b>Return only listings that are new or have changed since your last run.</b><br>The actor keeps a ledger of every listing it has delivered for this search stream, with a fingerprint of <code>price / km / title / version / seller type</code>. A listing is emitted when its id is unknown (<code>_delta_status: \"new\"</code>) or its fingerprint changed (<code>\"updated\"</code>, with <code>_changed_fields</code>, <code>_previous_price</code> and <code>_price_delta</code> — negative is a price drop). Unchanged listings are skipped and <b>not charged</b>.<br><br>The first run captures a full baseline. Schedule the same input afterwards (e.g. daily) to receive only the deltas. Entries unseen for 90 days expire.",
            "default": false
          },
          "cursorId": {
            "title": "🏷️ Stream id (cursor namespace)",
            "type": "string",
            "description": "<b>Optional.</b> Names the ingestion stream. Runs sharing a stream id share one ledger; different ids are fully independent.<br><br>Leave empty and the actor derives a stable id from your filters, which is normally what you want. Set it explicitly (e.g. <code>catalogue-cl</code>) when you shard one catalogue across several searches, so a listing that appears in two shards is delivered once."
          },
          "emitSeenIds": {
            "title": "📤 Emit seen ids (delisting detection)",
            "type": "boolean",
            "description": "<b>Write every listing id observed during the sweep to <code>SEEN_IDS</code></b> in the run's key-value store — including those skipped as unchanged.<br><br>With incremental ingestion your catalogue never expires rows on its own: a sold vehicle simply stops appearing. Compare <code>SEEN_IDS</code> against your catalogue to mark it as sold — but only when <code>reconcilable</code> is <code>true</code>. A sweep cut short by <b>Max results</b>, the spending limit or failed pages reports <code>reconcilable: false</code>, and absence then means <i>unknown</i>, not sold.",
            "default": false
          },
          "stripSellerPII": {
            "title": "🔒 Strip seller personal data",
            "type": "boolean",
            "description": "<b>Remove personal data of private sellers from the output.</b><br>The actor never collects phone numbers (chileautos.cl hides them behind login), but private sellers often type their phone or e-mail into the description. When enabled, phone numbers and e-mails in descriptions of <b>private</b> sellers are replaced with <code>[REDACTED]</code>.<br><br>Dealer data is commercial and is not modified. Recommended if you store the data under Chile's Ley 19.628 / Ley 21.719.",
            "default": false
          },
          "sort": {
            "title": "📶 Sort order",
            "enum": [
              "LastUpdated",
              "~LastUpdated",
              "topdeal",
              "~Price",
              "Price",
              "Year",
              "~Year",
              "~Odometer",
              "Odometer"
            ],
            "type": "string",
            "description": "Order of the results. Applies when the search has 900 results or fewer, or when <b>Max results</b> is 900 or less. Larger searches are split by price and come out grouped by price range.",
            "default": "LastUpdated"
          },
          "searchExpression": {
            "title": "🧮 Raw search expression",
            "type": "string",
            "description": "<b>For power users.</b> The site's internal query language, e.g. <code>(And.TipoVehículo.Autos._.Marca.Toyota._.Ano.range(2020..).)</code>. Replaces the search filters. Values are case-insensitive but accent-sensitive."
          },
          "maxConcurrency": {
            "title": "⚡ Max concurrency",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Parallel requests. 5 is safe; 10 halves the time of a full-marketplace run. Higher values raise the chance of rate limiting.",
            "default": 5
          },
          "proxyConfiguration": {
            "title": "🛡️ Proxy configuration",
            "type": "object",
            "description": "Apify datacenter proxy works for chileautos.cl (tested on a full 62,000-listing sweep). Switch to residential, country <code>CL</code>, only if the log shows many blocked requests.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}