{ "openapi": "3.0.1", "info": { "title": "NHTSA Vehicle Recalls & Complaints Scraper - By Make & Model", "description": "Scrape official NHTSA safety recalls and owner defect complaints by vehicle make, model, and model year with crash, fire, injury, and component details.", "version": "0.1", "x-build-id": "gwuJFHGicNnTOdMcY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/groundplanes~nhtsa-recalls-complaints/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-groundplanes-nhtsa-recalls-complaints", "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/groundplanes~nhtsa-recalls-complaints/runs": { "post": { "operationId": "runs-sync-groundplanes-nhtsa-recalls-complaints", "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/groundplanes~nhtsa-recalls-complaints/run-sync": { "post": { "operationId": "run-sync-groundplanes-nhtsa-recalls-complaints", "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": { "allModelsForMake": { "title": "Enumerate All Models for Make & Year", "type": "boolean", "description": "When enabled, queries NHTSA's vehicle models endpoint for each make + modelYear in 'vehicles' and fetches recalls/complaints across all models for that make and year.", "default": false }, "componentFilterKeyword": { "title": "Component Filter Keyword", "type": "string", "description": "Optional case-insensitive substring to filter by NHTSA component name (e.g. \"ELECTRICAL\", \"BRAKES\", \"FUEL\", \"STEERING\"). Leave blank for all components.", "default": "" }, "crashOrFireOnly": { "title": "Crash or Fire Incidents Only", "type": "boolean", "description": "When enabled, keeps only records where crash is true, fire is true, or parkIt is true.", "default": false }, "includeComplaintNarrative": { "title": "Include Complaint Narrative (summary field)", "type": "boolean", "description": "Defaults to false for privacy. Consumer complaint narratives are free text and can contain dealer street addresses and phone numbers, so when this is false complaint rows omit the summary field entirely. Set to true to include the complaint narrative in the summary field on COMPLAINT rows. Recall summary and remedy text is manufacturer-authored and is always included.", "default": false }, "maxItems": { "title": "Max Items", "minimum": 1, "type": "integer", "description": "Maximum number of records to return, sorted newest first by record date.", "default": 200 }, "mode": { "title": "Record Mode", "enum": [ "BOTH", "RECALLS", "COMPLAINTS" ], "type": "string", "description": "Choose whether to return RECALLS only, COMPLAINTS only, or BOTH recalls and complaints.", "default": "BOTH" }, "vehicles": { "title": "Vehicles (Make, Model, Model Year)", "type": "array", "description": "Array of vehicle objects with make, model, and modelYear (e.g. [{\"make\": \"honda\", \"model\": \"accord\", \"modelYear\": 2020}]). When allModelsForMake is true, model may be omitted or left blank.", "default": [ { "make": "honda", "model": "accord", "modelYear": 2020 } ] } } }, "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 } } } } } } } } } }