{ "openapi": "3.0.1", "info": { "title": "NHTSA Vehicle Recalls — By Make, Model & Year", "description": "US vehicle recalls from NHTSA's official API: campaign number, component, summary, consequence, remedy, report date, park-it flags, units affected. Search by make, model and year or by campaign number, and flag recalls that are new since your last run.", "version": "0.1", "x-build-id": "cBoi5wS0xnUoBAXqe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/northbell~nhtsa-vehicle-recalls/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-northbell-nhtsa-vehicle-recalls", "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/northbell~nhtsa-vehicle-recalls/runs": { "post": { "operationId": "runs-sync-northbell-nhtsa-vehicle-recalls", "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/northbell~nhtsa-vehicle-recalls/run-sync": { "post": { "operationId": "run-sync-northbell-nhtsa-vehicle-recalls", "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": { "vehicles": { "title": "Vehicles (make, model, model year)", "type": "array", "description": "The vehicles to check, as a list of {\"make\": \"Ford\", \"model\": \"F-150\", \"modelYear\": 2020}. modelYear can also be a range such as \"2018-2020\" (one lookup per year). Spell make and model as NHTSA does (not case sensitive): Ford, F-150; Tesla, Model 3; Mercedes-Benz, GLE 350. A line of text \"Ford, F-150, 2020\" works too. A vehicle with no recalls returns no rows." }, "campaignNumbers": { "title": "Campaign numbers (optional)", "type": "array", "description": "Look up recalls directly by NHTSA campaign number, one per line, for example 23V838 or 23V838000 (V = vehicle, E = equipment, T = tire, C = child seat). You get one row per campaign with the list of affected vehicles and the number of units.", "items": { "type": "string" } }, "includeUnitsAffected": { "title": "Add the number of units affected to vehicle rows", "type": "boolean", "description": "NHTSA does not send the number of potentially affected units with a vehicle search, so this makes one extra request per recall campaign. Rows from campaign numbers always have it. Slower, same price.", "default": false }, "includeComplaintCounts": { "title": "Add the number of NHTSA complaints for each vehicle", "type": "boolean", "description": "Adds complaintCount to every row: how many owner complaints NHTSA has on file for that make, model and year (not for the single recall). One extra request per vehicle. Also listed for vehicles with no recalls in the run summary.", "default": false }, "output": { "title": "What to return", "enum": [ "all", "new" ], "type": "string", "description": "With \"Only new\", recalls you already got for that vehicle in an earlier run are skipped and not charged. The first run for each vehicle returns everything, because there is nothing to compare with yet.", "default": "all" }, "maxResults": { "title": "Maximum recalls", "minimum": 1, "maximum": 5000, "type": "integer", "description": "How many recall rows to return in total, vehicles in the order you listed them, newest report date first within a vehicle. You pay per row returned.", "default": 200 } } }, "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 } } } } } } } } } }