{ "openapi": "3.0.1", "info": { "title": "NHTSA Recalls Scraper - Car Recall Lookup API", "description": "Scrape official US vehicle safety recalls and complaints from NHTSA by make, model, year, VIN or campaign number. No API key. Get recall campaign numbers, components, defect summaries, remedies, units affected, do-not-drive advisories, plus NCAP safety ratings.", "version": "0.2", "x-build-id": "IoyJwXH0NxhxsoHKl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~nhtsa-recalls-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-nhtsa-recalls-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/scrapers_lat~nhtsa-recalls-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-nhtsa-recalls-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/scrapers_lat~nhtsa-recalls-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-nhtsa-recalls-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": { "dataset": { "title": "Dataset", "enum": [ "recalls", "complaints" ], "type": "string", "description": "Choose what to collect: official manufacturer safety recall campaigns, or consumer complaints filed with NHTSA. Each combination of make, model and year is queried for the selected dataset.", "default": "recalls" }, "makes": { "title": "Makes", "type": "array", "description": "Vehicle makes to query, for example Honda, Toyota, Ford. One make per line. Case-insensitive.", "items": { "type": "string" } }, "models": { "title": "Models", "type": "array", "description": "Vehicle models to query, for example Accord, Camry, F-150. One model per line.", "items": { "type": "string" } }, "modelYears": { "title": "Model Years", "type": "array", "description": "Model years to query, for example 2020, 2021. One four-digit year per line.", "items": { "type": "string" } }, "campaignNumbers": { "title": "Recall campaign numbers", "type": "array", "description": "Look up recalls directly by NHTSA campaign number, for example 20V505000. One per line. When set, make/model/year are ignored.", "items": { "type": "string" } }, "vins": { "title": "VINs", "type": "array", "description": "Look up recalls (or complaints) by 17-character VIN. Each VIN is decoded to make, model and year, then queried. One VIN per line.", "items": { "type": "string" } }, "components": { "title": "Component filter", "type": "array", "description": "Optional. Keep only records whose component matches any of these terms, for example AIR BAGS, FUEL SYSTEM, ELECTRICAL. Case-insensitive substring match. One term per line.", "items": { "type": "string" } }, "includeComplaintsSummary": { "title": "Add complaint summary (paid add-on)", "type": "boolean", "description": "Recalls dataset only. For each recall, add a consumer-complaint summary for the same vehicle: total complaints, crash/fire counts, injuries, deaths, top components and date range. Billed as the details event, only on genuine data, for paying users. Free runs return recalls only.", "default": false }, "includeSafetyRatings": { "title": "Add NCAP safety ratings + investigation count (paid add-on)", "type": "boolean", "description": "Recalls dataset only. For each recall, add NHTSA NCAP crash-test star ratings (overall, front, side, rollover) with crash-test photo/video URLs, plus the vehicle's open-investigation, complaint and recall counts. Billed as the details event, only on genuine data, for paying users.", "default": false }, "maxRecalls": { "title": "Max results", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of records to collect across all queries. Leave empty for all. Free Apify plans are capped at 10 per run." } } }, "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 } } } } } } } } } }