{ "openapi": "3.0.1", "info": { "title": "Bulk VIN Decoder + NHTSA Recalls, Complaints & Safety Ratings", "description": "Decode thousands of US VINs in one run and get specs, NHTSA safety recalls, complaint counts (crash, fire, injury) and NCAP star ratings in one flat row per vehicle. Official NHTSA APIs, invalid VINs flagged and never charged.", "version": "0.1", "x-build-id": "UMNdOag4eHzdnSdDO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nefes-tools~vehicle-vin-recalls/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nefes-tools-vehicle-vin-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/nefes-tools~vehicle-vin-recalls/runs": { "post": { "operationId": "runs-sync-nefes-tools-vehicle-vin-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/nefes-tools~vehicle-vin-recalls/run-sync": { "post": { "operationId": "run-sync-nefes-tools-vehicle-vin-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": { "vins": { "title": "VINs", "type": "array", "description": "17-character Vehicle Identification Numbers, one per line (you can also paste a comma- or space-separated list into one line). Each VIN is checked with its check digit first; invalid VINs are flagged in the output and never charged. Duplicates are skipped.", "items": { "type": "string" } }, "vehicles": { "title": "Vehicles by make / model / year", "type": "array", "description": "No VIN? Enter vehicles like \"2019 Honda Civic\" or \"Ford, F-150, 2013\". You get recalls, complaint counts and star ratings for that model year (no VIN-specific specs).", "items": { "type": "string" } }, "includeRecalls": { "title": "Safety recalls", "type": "boolean", "description": "Add NHTSA safety recall campaigns for the vehicle's make, model and model year (count, campaign numbers, components, remedy, 'park it' warnings).", "default": true }, "includeComplaints": { "title": "Complaint statistics", "type": "boolean", "description": "Add counts of owner complaints filed with NHTSA: total, with crash, fire, injury or death, and the most complained-about components. Only numbers are returned, never complaint texts or personal data.", "default": true }, "includeSafetyRatings": { "title": "NCAP safety ratings (stars)", "type": "boolean", "description": "Add NHTSA 5-Star Safety Ratings: overall, frontal, side and rollover, for the closest matching body style and drive.", "default": true }, "recallRows": { "title": "Also output one row per recall", "type": "boolean", "description": "Besides the one row per vehicle, add a separate row for every recall campaign (rowType = \"recall\"). Handy for filtering in a spreadsheet. These extra rows are free.", "default": false }, "includeInvalid": { "title": "Show invalid VINs in the output", "type": "boolean", "description": "Keep a row (status = invalid_vin, free of charge) for VINs that fail the check-digit test, so you can fix typos. Turn off to skip them silently.", "default": true }, "maxResults": { "title": "Max vehicles", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many successfully processed vehicles (each is one charged result). Invalid or unknown VINs do not count.", "default": 1000 } } }, "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 } } } } } } } } } }