{ "openapi": "3.0.1", "info": { "title": "Vehicle Defect Tracker, Complaints & Recall Gaps", "description": "Every owner complaint filed with NHTSA for a vehicle, keyless, with crash, fire, injury and death flags and the full narrative. Roll them up by component and see which failures owners keep reporting that no recall covers. Deduped properly, so counts are real.", "version": "0.1", "x-build-id": "VBOhy6vuyuMIpSKTp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapemint~vehicle-defect-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapemint-vehicle-defect-tracker", "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/scrapemint~vehicle-defect-tracker/runs": { "post": { "operationId": "runs-sync-scrapemint-vehicle-defect-tracker", "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/scrapemint~vehicle-defect-tracker/run-sync": { "post": { "operationId": "run-sync-scrapemint-vehicle-defect-tracker", "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": { "mode": { "title": "Mode", "enum": [ "complaints", "componentTrends" ], "type": "string", "description": "Complaints returns one row per owner complaint with the full narrative. Component trends rolls them up per failing part and flags the ones no recall covers.", "default": "complaints" }, "make": { "title": "Make", "type": "string", "description": "Vehicle manufacturer, for example Ford, Honda, Tesla." }, "model": { "title": "Model", "type": "string", "description": "Model name, for example Explorer or F-150. NHTSA stores some models only as body-style entries such as \"F-150 SUPER CREW\", and rejects the plain name outright. Type the plain name: the variants are found and merged for you, with duplicates removed." }, "yearFrom": { "title": "From model year", "minimum": 1949, "maximum": 2100, "type": "integer", "description": "Earliest model year. Set this alone to do a single year." }, "yearTo": { "title": "To model year", "minimum": 1949, "maximum": 2100, "type": "integer", "description": "Latest model year. Leave empty to use the same year as above. Up to 60 years per run." }, "minSeverity": { "title": "Minimum severity", "enum": [ "all", "crashOrFire", "injuryOrDeath" ], "type": "string", "description": "Severity comes from what the owner reported: a death, an injury, a fire, or a crash. Most complaints report none of these, which is a real finding rather than missing data.", "default": "all" }, "components": { "title": "Components", "type": "array", "description": "Filter to specific failing parts as NHTSA names them, for example POWER TRAIN, ENGINE, ELECTRICAL SYSTEM, AIR BAGS. Leave empty for all of them.", "default": [], "items": { "type": "string" } }, "dateFrom": { "title": "From incident date", "type": "string", "description": "Earliest date the failure happened, as YYYY-MM-DD. Filters run on the incident date, not the filing date: owners often report months or years late, so filing dates would put old failures in recent buckets." }, "dateTo": { "title": "To incident date", "type": "string", "description": "Latest incident date as YYYY-MM-DD." }, "includeRecallCheck": { "title": "Check recalls", "type": "boolean", "description": "Fetch recalls for the same vehicle and mark whether any covers each complaint's component. Turning this off leaves the recall fields empty rather than false, so absence stays distinct from a real no.", "default": true }, "includeSummary": { "title": "Include owner narrative", "type": "boolean", "description": "The owner's description of what happened. Long, and the most useful field if you are reading rather than counting.", "default": true }, "newOnly": { "title": "Monitor mode: new complaints only", "type": "boolean", "description": "Remember complaints already returned and emit only ones filed since. Run it weekly on the models you care about. Quiet runs cost nothing.", "default": false }, "maxRows": { "title": "Max rows", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Stop after this many rows.", "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 } } }, "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 } } } } } } } } } }