{
"openapi": "3.0.1",
"info": {
"title": "CARFAX Scraper | Used Cars, Prices and History",
"description": "CARFAX scraper for used car listings: 20 vehicles in 6 seconds, 84 fields each. Search by make and model, carfax.com link or VIN and get price, CARFAX value, deal rating, mileage, accident summary, owners, service records, options, dealer phone and rating, photos. No account. Export to CSV or Excel.",
"version": "1.0",
"x-build-id": "NBW1C8seeHD0bJ0ek"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/silentflow~carfax-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-silentflow-carfax-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~carfax-scraper/runs": {
"post": {
"operationId": "runs-sync-silentflow-carfax-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~carfax-scraper/run-sync": {
"post": {
"operationId": "run-sync-silentflow-carfax-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": {
"searchQueries": {
"title": "🔎 Make and model",
"type": "array",
"description": "One search per line: a make, a make and model, with optional model years. Examples: Toyota Camry, 2021 Ford F-150, 2019-2022 Honda Civic, Tesla, Ford pickup trucks. Short names work too (chevy, vw). A carfax.com link or a VIN typed here is read as such.",
"items": {
"type": "string"
}
},
"startUrls": {
"title": "🔗 CARFAX links",
"type": "array",
"description": "carfax.com pages to collect, one per line: a search with your filters (https://www.carfax.com/Used-Toyota-Camry_w630?zip=90210&radius=50), a brand, model, year or body style page, or a vehicle page (https://www.carfax.com/vehicle/4T1DAACK7SU201242). The filters of the link are kept.",
"items": {
"type": "string"
}
},
"vins": {
"title": "🔑 VINs",
"type": "array",
"description": "17-character VINs of vehicles listed for sale on CARFAX, one per line, for example 4T1DAACK7SU201242. Each VIN found returns one full row; a VIN that is not for sale right now returns nothing.",
"items": {
"type": "string"
}
},
"zipCode": {
"title": "📍 ZIP code",
"type": "string",
"description": "US ZIP code the searches start from, for example 90012 (Los Angeles) or 10001 (New York). Leave empty to search the whole country."
},
"maxItems": {
"title": "🔢 Max vehicles",
"minimum": 1,
"type": "integer",
"description": "Most vehicles to return across all searches, links and VINs. One search returns up to 1,250 vehicles, and larger searches are collected two model years at a time.",
"default": 100
},
"radius": {
"title": "📏 Search radius",
"enum": [
"10",
"25",
"50",
"75",
"100",
"150",
"200",
"250",
"500",
"3000"
],
"type": "string",
"description": "How far from the ZIP code to look. Only used with a ZIP code.",
"default": "50"
},
"sortBy": {
"title": "↕️ Sort by",
"enum": [
"BEST",
"PRICE_ASC",
"PRICE_DESC",
"MILEAGE_ASC",
"MILEAGE_DESC",
"YEAR_DESC",
"YEAR_ASC",
"LISTING_DATE_DESC",
"DISTANCE_ASC"
],
"type": "string",
"description": "Order of the results. With a cap, the order decides which vehicles you get first: lowest price, lowest mileage, newest listings.",
"default": "BEST"
},
"maxPrice": {
"title": "💵 Max price (USD)",
"minimum": 0,
"type": "integer",
"description": "Only vehicles at or under this price, for example 25000. Leave empty for no cap."
},
"historyFilters": {
"title": "🛡️ CARFAX history",
"type": "array",
"description": "Keep only vehicles with a clean CARFAX history: no accident reported, one owner, service records, personal use. Each choice narrows the results.",
"items": {
"type": "string",
"enum": [
"noAccidents",
"oneOwner",
"serviceRecords",
"personalUse"
],
"enumTitles": [
"No accident or damage reported",
"One owner",
"Service records",
"Personal use"
]
}
},
"includeDetails": {
"title": "📝 Seller comments and history report link",
"type": "boolean",
"description": "Add the dealer's description of the car, the full option list and the link to the free CARFAX history report when the dealer shares it. Turn off for faster runs on very large searches.",
"default": 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
}
}
}
}
}
}
}
}
}
}