{
  "openapi": "3.0.1",
  "info": {
    "title": "Encar Scraper | Used Car Listings and Accident History",
    "description": "Encar scraper (엔카) for Korean used car listings: price, mileage, VIN, plate, specs and options in English, the insurance accident record with each claim's cost, the inspection report and the dealer's phone. Search by make and model or paste Encar URLs. 20 cars in 10 seconds, 70 fields each.",
    "version": "1.0",
    "x-build-id": "1IZcOXvas2QS8wJL6"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/silentflow~encar-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-silentflow-encar-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/silentflow~encar-scraper/runs": {
      "post": {
        "operationId": "runs-sync-silentflow-encar-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/silentflow~encar-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-silentflow-encar-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": {
          "searches": {
            "title": "🔎 Make and model",
            "type": "array",
            "description": "One or more cars to search, each with its own cap. Start with the make, then the model, in English or Korean: <code>Hyundai Grandeur</code>, <code>Kia Sorento</code>, <code>Genesis G80</code>, <code>BMW 5 Series</code>, <code>Mercedes-Benz E-Class</code>, <code>현대 그랜저</code>. A make alone (<code>Tesla</code>) searches all its models. Leave it empty with no URL to search all of Encar under the filters below.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "🔗 Encar search or listing URLs",
            "type": "array",
            "description": "Paste any encar.com address copied from your browser:<ul><li><b>A search page</b>, with every filter you set on the site applied as is (trim, color, options, region, accident-free, Encar diagnosis): <code>https://www.encar.com/dc/dc_carsearchlist.do?carType=kor#!...</code> or <code>https://car.encar.com/list/car?search=...</code></li><li><b>A car listing</b>, to get that car in full whatever the cap: <code>https://fem.encar.com/cars/detail/42708841</code></li></ul>Many URLs are read in one run.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "maxItems": {
            "title": "🔢 Max cars per search",
            "minimum": 1,
            "type": "integer",
            "description": "Stop each make and model and each search URL after this many cars. Encar pages one search up to 10,000 cars; split bigger jobs by model. Listing URLs always give their row, whatever this cap. The cost grows with the number of cars.",
            "default": 100
          },
          "sortBy": {
            "title": "↕️ Sort by",
            "enum": [
              "newest",
              "price_asc",
              "price_desc",
              "mileage_asc",
              "mileage_desc",
              "year_newest"
            ],
            "type": "string",
            "description": "Order of the cars, as on encar.com. Price sorts list plain sales only: a lease or rental takeover shows a contract figure, not a sale price, and would sort first. A pasted search URL keeps its own order.",
            "default": "newest"
          },
          "carType": {
            "title": "🚗 Korean or imported brands",
            "enum": [
              "all",
              "domestic",
              "imported"
            ],
            "type": "string",
            "description": "Used when no make is typed: all of Encar, Korean brands only or imported brands only. A typed make decides on its own.",
            "default": "all"
          },
          "minYear": {
            "title": "📅 First registered from",
            "minimum": 1950,
            "maximum": 2030,
            "type": "integer",
            "description": "Only cars first registered in this year or later, for example <code>2020</code>. Leave empty for any year."
          },
          "maxYear": {
            "title": "📅 First registered up to",
            "minimum": 1950,
            "maximum": 2030,
            "type": "integer",
            "description": "Only cars first registered in this year or earlier, for example <code>2023</code>. With the field above it gives a year range. Leave empty for any year."
          },
          "minPrice": {
            "title": "💰 Min price (만원, 10,000 KRW)",
            "minimum": 1,
            "type": "integer",
            "description": "Lowest asking price in 만원, the unit every Encar price is shown in: <code>1500</code> means 15,000,000 KRW. Leave empty for any price."
          },
          "maxPrice": {
            "title": "💰 Max price (만원, 10,000 KRW)",
            "minimum": 1,
            "type": "integer",
            "description": "Highest asking price in 만원, the unit every Encar price is shown in: <code>3000</code> means 30,000,000 KRW. Rows give the price in both units. Leave empty for any price."
          },
          "maxMileage": {
            "title": "🛣️ Max mileage (km)",
            "minimum": 1,
            "type": "integer",
            "description": "Highest odometer reading in kilometres, for example <code>80000</code>. Leave empty for any mileage."
          },
          "fuelType": {
            "title": "⛽ Fuel",
            "enum": [
              "any",
              "gasoline",
              "diesel",
              "hybrid",
              "electric",
              "lpg",
              "hydrogen"
            ],
            "type": "string",
            "description": "Only cars with this fuel. Hybrid covers gasoline, diesel and LPG hybrids.",
            "default": "any"
          },
          "accidentFree": {
            "title": "🛡️ Accident-free cars only",
            "type": "boolean",
            "description": "Keep only cars Encar files as accident-free (무사고): no accident on record. Small repairs and insurance claims can still appear, and every row carries its claims and inspection findings, so you can filter further yourself.",
            "default": false
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}