{ "openapi": "3.0.1", "info": { "title": "VIN Decoder + NHTSA Recalls & Complaints: One Call", "description": "Decode any US VIN into full specs, then pull every open NHTSA recall and consumer complaint for that vehicle in one merged record. Skip juggling separate VIN, recall, and complaint tools. Accepts VIN or make/model/year. $0.0018 per vehicle.", "version": "0.1", "x-build-id": "CuwghDwlfTeSRDJJZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~nhtsa-vehicle-intelligence-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-nhtsa-vehicle-intelligence-monitor", "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/getascraper~nhtsa-vehicle-intelligence-monitor/runs": { "post": { "operationId": "runs-sync-getascraper-nhtsa-vehicle-intelligence-monitor", "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/getascraper~nhtsa-vehicle-intelligence-monitor/run-sync": { "post": { "operationId": "run-sync-getascraper-nhtsa-vehicle-intelligence-monitor", "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": { "vins": { "title": "VINs to decode", "type": "array", "description": "One or more 17-character Vehicle Identification Numbers. Each VIN is decoded, then matched to its make/model/year to pull recalls and complaints.", "default": [], "items": { "type": "string" } }, "vehicles": { "title": "Make / model / year combinations", "type": "array", "description": "Vehicles to look up without a VIN, e.g. { \"make\": \"Honda\", \"model\": \"Accord\", \"year\": 2003 }. Skips VIN decoding and goes straight to recalls and complaints.", "default": [] }, "complaintSeverityFilter": { "title": "Complaint severity filter", "enum": [ "all", "crashOnly", "fireOnly", "crashOrFireOnly", "injuryOrDeathOnly" ], "type": "string", "description": "Only include complaints matching this severity. This is checked after complaints are pulled, so it doesn't speed up the run: it just narrows what's included in your data, not the true total count.", "default": "all" }, "complaintComponentFilter": { "title": "Complaint component filter", "type": "string", "description": "Only include complaints whose component field contains this text, e.g. \"AIR BAGS\" or \"ENGINE\" (not case-sensitive). Leave blank to include all components. Same as the severity filter above: this only narrows what's included, not how fast the run goes.", "default": "" }, "includeRecalls": { "title": "Include recalls", "type": "boolean", "description": "Include NHTSA safety recall data for each vehicle. Turn off to skip it and cut runtime and cost if you only need complaints or a VIN decode.", "default": true }, "includeComplaints": { "title": "Include complaints", "type": "boolean", "description": "Include NHTSA consumer complaint data for each vehicle. Turn off to skip it and cut runtime and cost if you only need recalls or a VIN decode.", "default": true }, "maxComplaintsPerVehicle": { "title": "Max complaints per vehicle", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Popular models can have thousands of complaints on file. Cap how many are attached to each record (the true total count is always included).", "default": 50 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many vehicles to look up at the same time. Keep this modest since this data is free and open to everyone.", "default": 5 } } }, "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 } } }, "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 } } } } } } } } } }