{
  "openapi": "3.0.1",
  "info": {
    "title": "CarSensor Japan Scraper - Used Cars, Prices & Dealers",
    "description": "Scrape CarSensor (carsensor.net) used car listings across Japan by maker, model, prefecture, filters or URL. Extract prices, year, mileage, inspection, warranty, equipment, quality reports, photos and dealer details. Supports recurring price change monitoring.",
    "version": "0.1",
    "x-build-id": "K5GdZVThkp0OYpqzK"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/abotapi~carsensor-net-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-abotapi-carsensor-net-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/abotapi~carsensor-net-scraper/runs": {
      "post": {
        "operationId": "runs-sync-abotapi-carsensor-net-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/abotapi~carsensor-net-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-abotapi-carsensor-net-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",
        "required": [
          "mode"
        ],
        "properties": {
          "mode": {
            "title": "Mode",
            "enum": [
              "search",
              "url"
            ],
            "type": "string",
            "description": "Search by filters walks the result pages for the maker, model, prefecture and filters below. Paste links walks the links you paste, forward from the page each link names.",
            "default": "search"
          },
          "keywords": {
            "title": "Keywords",
            "type": "string",
            "description": "Free-text search, for example a model name such as プリウス or a grade or equipment word. Works together with the maker and the prefecture."
          },
          "maker": {
            "title": "Maker",
            "type": "string",
            "description": "The maker as a code (TO for Toyota, NI for Nissan, HO for Honda), the Japanese name (トヨタ) or a common English name (Toyota). Leave empty for every maker."
          },
          "model": {
            "title": "Model code",
            "type": "string",
            "description": "The model code from the site's own address, for example S149 for the Land Cruiser 70 (the part after the s in /usedcar/bTO/s149/). Needs a maker. Leave empty for every model of the maker."
          },
          "prefecture": {
            "title": "Prefecture",
            "enum": [
              "",
              "hokkaido",
              "aomori",
              "iwate",
              "miyagi",
              "akita",
              "yamagata",
              "fukushima",
              "ibaraki",
              "tochigi",
              "gunma",
              "saitama",
              "chiba",
              "tokyo",
              "kanagawa",
              "niigata",
              "toyama",
              "ishikawa",
              "fukui",
              "yamanashi",
              "nagano",
              "gifu",
              "shizuoka",
              "aichi",
              "mie",
              "shiga",
              "kyoto",
              "osaka",
              "hyogo",
              "nara",
              "wakayama",
              "tottori",
              "shimane",
              "okayama",
              "hiroshima",
              "yamaguchi",
              "tokushima",
              "kagawa",
              "ehime",
              "kochi",
              "fukuoka",
              "saga",
              "nagasaki",
              "kumamoto",
              "oita",
              "miyazaki",
              "kagoshima",
              "okinawa"
            ],
            "type": "string",
            "description": "Only cars on sale in this prefecture. Any prefecture searches the whole country.",
            "default": ""
          },
          "minPrice": {
            "title": "Minimum total price (JPY)",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest total price in yen, taxes and fees included, for example 1000000."
          },
          "maxPrice": {
            "title": "Maximum total price (JPY)",
            "minimum": 0,
            "type": "integer",
            "description": "Highest total price in yen, taxes and fees included, for example 2000000."
          },
          "minYear": {
            "title": "Earliest model year",
            "minimum": 1980,
            "maximum": 2030,
            "type": "integer",
            "description": "Only cars first registered in this year or later, for example 2018."
          },
          "maxYear": {
            "title": "Latest model year",
            "minimum": 1980,
            "maximum": 2030,
            "type": "integer",
            "description": "Only cars first registered in this year or earlier, for example 2022."
          },
          "maxMileageKm": {
            "title": "Maximum mileage (km)",
            "minimum": 0,
            "type": "integer",
            "description": "Only cars with at most this many kilometres on the clock, for example 50000."
          },
          "bodyType": {
            "title": "Body type",
            "enum": [
              "any",
              "coupe",
              "minivan",
              "hatchback",
              "wagon",
              "convertible",
              "suv",
              "pickup",
              "sedan",
              "truck",
              "other"
            ],
            "type": "string",
            "description": "Only cars of this body type, applied by the site itself.",
            "default": "any"
          },
          "sortBy": {
            "title": "Sort order",
            "enum": [
              "default",
              "newest",
              "totalPriceAsc",
              "totalPriceDesc",
              "yearNewest",
              "mileageLowest"
            ],
            "type": "string",
            "description": "Order of the results, applied by the site itself (checked on the first rows of a model search). The default keeps the site's own order.",
            "default": "default"
          },
          "urls": {
            "title": "CarSensor links",
            "type": "array",
            "description": "Multi-URL, filter fields ignored, pagination walks forward. Paste result pages (the national list, a maker, a maker and model, a prefecture, a body-type page, a search with filters), a dealer page (its stock list is read) or single car pages (detail and lease pages, tracking parameters are fine). Pagination starts at the page named in the link and walks forward.",
            "default": [
              "https://www.carsensor.net/usedcar/",
              "https://www.carsensor.net/usedcar/bTO/index.html",
              "https://www.carsensor.net/usedcar/bTO/s149/index.html",
              "https://www.carsensor.net/usedcar/bTO/s149/index2.html",
              "https://www.carsensor.net/usedcar/bTO/s149/a34/index.html",
              "https://www.carsensor.net/usedcar/bodytype/suv/index.html",
              "https://www.carsensor.net/usedcar/search.php?KW=%E3%83%97%E3%83%AA%E3%82%A6%E3%82%B9&PMIN=1000000&PMAX=2000000&YMIN=2018&SMAX=50000",
              "https://www.carsensor.net/usedcar/bTO/s149/index.html?SORT=2",
              "https://www.carsensor.net/usedcar/shashu/bTO/index.html",
              "https://www.carsensor.net/usedcar/detail/AU7383991961/index.html",
              "https://www.carsensor.net/usedcar/detail/AU7383991961/index.html?TRCD=200002&RESTID=CS210610",
              "https://www.carsensor.net/usedcar/lease/AU7174821896/",
              "https://www.carsensor.net/shop/chiba/312461002/",
              "https://carsensor.net/usedcar/"
            ],
            "items": {
              "type": "string"
            }
          },
          "fetchDetails": {
            "title": "Read each car's own page",
            "type": "boolean",
            "description": "The result page carries price, year, mileage, inspection, warranty, area and the dealer name. A car's own page adds the equipment list, the full photo set, the quality report, the warranty text, the full spec table and the dealer address, hours and phone. A per-car detail-enrichment charge applies to every car whose page was read. Single car links and dealer stock lists are always read from the car pages.",
            "default": true
          },
          "maxPages": {
            "title": "Max pages per source",
            "minimum": 0,
            "type": "integer",
            "description": "Optional guard per search or link: stop after this many result pages. Empty or 0 (the default) means no page limit. It does not cap the run and defers to Max items, which is the single cap (default 20)."
          },
          "maxItems": {
            "title": "Max items",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "The single limit that stops a run. Default 20 cars; 0 means no limit (at most 1,000,000).",
            "default": 20
          },
          "proxy": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "The site serves its pages to the standard Apify proxy pool, so that is the default. Residential also works and is recommended for the most reliable results on large or frequent runs.",
            "default": {
              "useApifyProxy": true
            }
          },
          "resumeFromRunId": {
            "title": "Continue a previous run",
            "type": "string",
            "description": "Give the run id of an interrupted run and every car it already collected is skipped. Mutually exclusive with recurring updates once a baseline exists."
          },
          "incrementalMode": {
            "title": "Recurring updates (only return what changed)",
            "type": "boolean",
            "description": "Label every car NEW, UPDATED, UNCHANGED or REAPPEARED against the previous run of the same setup, and record the ones that vanished as EXPIRED. UPDATED means a compared field moved: total price, base price, mileage, inspection, warranty, repair history, equipment, quality score, photos, dealer details and the other listing facts. Never compared: the run time, the result page number and the search link the car was reached through. Unchanged cars are not returned unless you also turn on the return-unchanged switch. Returns (and bills) extra rows only for what changed.",
            "default": false
          },
          "stateKey": {
            "title": "State key (optional, recurring updates only)",
            "type": "string",
            "description": "Name the baseline of a recurring schedule yourself. Without it the baseline is keyed on the whole search setup, so two differently-configured schedules never share one baseline."
          },
          "emitUnchanged": {
            "title": "Also return unchanged cars (recurring updates only)",
            "type": "boolean",
            "description": "Returns (and bills) every tracked car again, labelled UNCHANGED, instead of only the changed ones.",
            "default": false
          },
          "emitExpired": {
            "title": "Also return cars that are gone (recurring updates only)",
            "type": "boolean",
            "description": "Cars tracked by the previous run but absent from a COMPLETE scan are returned (and billed) one last time, labelled EXPIRED. A run that stopped early never reports cars as gone.",
            "default": false
          },
          "changeScope": {
            "title": "What counts as a change (recurring updates only)",
            "enum": [
              "all",
              "priceAndStock"
            ],
            "type": "string",
            "description": "Any listing field: every compared field can make a car UPDATED. Price only: just the total price, base price and extra costs decide UPDATED, so equipment, photo and dealer-copy edits never produce a returned row. Changing this changes which baseline an automatic state key uses.",
            "default": "all"
          },
          "compactUpdates": {
            "title": "Short rows for updated cars (recurring updates only)",
            "type": "boolean",
            "description": "UPDATED and EXPIRED rows come back short: ids, link, title, current prices and priceChanges with the old and new value of each moved field. New cars stay full. The per-car detail charge is not applied to a short row because it carries no detail fields.",
            "default": false
          },
          "expireAfterMissedScans": {
            "title": "Missed scans before a car is marked gone (recurring updates only)",
            "minimum": 1,
            "maximum": 30,
            "type": "integer",
            "description": "With the gone-cars switch on, a car is returned as EXPIRED only after it was missing from this many complete scans in a row. A car that left the results and a sold one look the same without opening each car page.",
            "default": 1
          },
          "ignoreFieldsForChanges": {
            "title": "Ignore fields when detecting changes (incremental mode only)",
            "type": "array",
            "description": "Field names that never make a car UPDATED and are left out of changedFields (they stay in the output). Use a dotted path to ignore one key inside a nested list, for example planPrices.plan. Leave empty to compare every listing field. Changing this changes which baseline an automatic state key uses.",
            "items": {
              "type": "string"
            }
          },
          "mcpConnectors": {
            "title": "Pipe results into your apps (optional)",
            "type": "array",
            "description": "Optional delivery step AFTER the scrape: pipes dataset results into apps you connected in the Apify MCP Connector setup.",
            "items": {
              "type": "string"
            }
          },
          "notionParentPageUrl": {
            "title": "Notion parent page (Notion connector only)",
            "type": "string",
            "description": "Notion connector only: the parent page new Notion pages attach under."
          },
          "maxNotifyListings": {
            "title": "Max items to export per connector",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "How many dataset rows at most each connector receives per run.",
            "default": 50
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}