NHTSA Recalls Scraper: Car Recall Lookup API (Make, Model, Year, VIN)

Look up official US vehicle safety recalls and consumer complaints from the NHTSA database by make, model and year, by VIN, or by recall campaign number. No API key, no account with NHTSA, no browser. Get recall campaign numbers, affected components, defect summaries, consequences, remedies, units affected and do-not-drive / park-outside advisories, and optionally enrich each recall with consumer-complaint statistics and NCAP crash-test safety ratings.

Here is one real recall record, with every base field the actor returns:

{
  "dataset": "recalls",
  "campaignNumber": "20V771000",
  "make": "HONDA",
  "model": "ACCORD",
  "modelYear": "2020",
  "component": "ELECTRICAL SYSTEM:BODY CONTROL MODULE:SOFTWARE",
  "summary": "Honda (American Honda Motor Co.) is recalling certain 2018-2020 Accord Sedan, Accord Hybrid, and 2019-2020 Insight vehicles. A software error may cause intermittent or continuous disruptions in communication between the Body Control Module (BCM) and other components.",
  "consequence": "Various system malfunctions such as inoperative windshield wipers, defroster, rearview camera, or exterior lighting can increase the risk of a crash.",
  "remedy": "Honda will notify owners, and dealers will update the BCM software, free of charge. Owners may contact Honda customer service at 1-888-234-2138.",
  "notes": "Owners may also contact the National Highway Traffic Safety Administration Vehicle Safety Hotline at 1-888-327-4236.",
  "manufacturer": "Honda (American Honda Motor Co.)",
  "reportReceivedDate": "2020-12-10",
  "reportReceivedDateRaw": "10/12/2020",
  "recallType": null,
  "potentialUnitsAffected": 737233,
  "parkIt": false,
  "parkOutSide": false,
  "overTheAirUpdate": false,
  "nhtsaRecallUrl": "https://www.nhtsa.gov/recalls?nhtsaId=20V771000",
  "associatedDocuments": null,
  "queriedVin": null,
  "observedAt": "2026-09-06T01:12:11.000Z",
  "error": null
}

📥 Input · 📤 Output · 💰 Pricing · ▶️ Examples

Table of contents

• What it does
• Why this scraper
• Quickstart
• Input reference
• Output reference
• Paid enrichment add-ons
• How we compare
• Run via API and CLI
• Fetch results
• Billing and limits
• FAQ and troubleshooting

What it does

This is a NHTSA recalls scraper and car recall lookup API for the US vehicle safety database. Give it a list of vehicles and it writes one normalized record per result to the run dataset:

• Recalls by make, model and year (recalls mode): official manufacturer safety recall campaigns.
• Recalls by VIN: each 17-character VIN is decoded to make, model and year, then queried.
• Recalls by campaign number: look up an exact NHTSA campaign, for example 20V505000.
• Consumer complaints (complaints mode): complaints filed with NHTSA, including crash, fire, injuries, deaths, incident dates and VIN.

Dates are normalized to YYYY-MM-DD (the raw NHTSA string is kept too), and missing source values are returned as null, never invented.

Why this scraper

• Four ways to look up: make/model/year, VIN, campaign number, or a component filter, in one actor.
• Units affected included: the estimated affected-vehicle population is added to every recall, a scale figure the per-vehicle NHTSA feed does not return by itself.
• Do-not-drive and park-outside advisories and over-the-air-update flags on every recall.
• Optional enrichment: attach consumer-complaint statistics and NCAP crash-test safety ratings (with open-investigation counts) to each recall.
• No API key, no browser, official public data, exported to JSON, CSV or Excel.

Quickstart

Open the actor, paste this into the input, and press Run. It returns up to 10 safety recall campaigns for the 2020 Honda Accord.

{
  "dataset": "recalls",
  "makes": ["Honda"],
  "models": ["Accord"],
  "modelYears": ["2020"],
  "maxRecalls": 10
}

Look up by campaign number instead:

{ "campaignNumbers": ["20V505000"] }

Look up by VIN:

{ "vins": ["1HGCV1F19LA000000"] }

Input reference

Field	Type	Required	Description
dataset	enum	no	recalls (default) or complaints. Alias: dataType.
makes	string[]	one lookup required	Vehicle makes, for example Honda, Toyota, Ford. Case-insensitive. Alias: make.
models	string[]	one lookup required	Vehicle models, for example Accord, Camry, F-150. Alias: model.
modelYears	string[]	one lookup required	Model years, for example 2020, 2021. Aliases: modelYear, year.
campaignNumbers	string[]	one lookup required	NHTSA recall campaign numbers, for example 20V505000. Alias: campaignNumber.
vins	string[]	one lookup required	17-character VINs, decoded to make/model/year then queried. Alias: vin.
components	string[]	no	Keep only records whose component matches any term, for example AIR BAGS. Case-insensitive.
includeComplaintsSummary	boolean	no	Paid add-on. Attach a complaint summary to each recall.
includeSafetyRatings	boolean	no	Paid add-on. Attach NCAP safety ratings and investigation count to each recall.
maxRecalls	integer	no	Maximum records across all queries. Aliases: maxItems, maxResults, maxRecords. Empty means all.

You need at least one of: make + model + model year, VINs, or campaign numbers. The actor queries every combination of make x model x model year you provide.

Output reference

One dataset item per result. Missing values are null, never invented.

Recalls mode (dataset: "recalls"):

Field	Type	Description
campaignNumber	string	NHTSA recall campaign number, for example 20V771000.
make, model, modelYear	string	Vehicle identity.
component	string	Affected component or system.
summary	string	Narrative summary of the recalled defect.
consequence	string	Safety consequence of the defect.
remedy	string	Manufacturer remedy and owner contact information.
notes	string	Additional NHTSA notes.
manufacturer	string	Manufacturer name.
reportReceivedDate	string	Date NHTSA received the recall report (YYYY-MM-DD).
reportReceivedDateRaw	string	The raw NHTSA date string, as returned.
recallType	string	Recall type when present, else null (not exposed by this feed).
potentialUnitsAffected	integer	Estimated number of vehicles affected.
parkIt	boolean	true when NHTSA advises not to drive the vehicle until repaired (do-not-drive advisory).
parkOutSide	boolean	true when NHTSA advises parking outside due to fire risk.
overTheAirUpdate	boolean	true when the remedy is an over-the-air update.
nhtsaRecallUrl	string	Direct link to the recall on nhtsa.gov.
associatedDocuments	null	Document URLs are not exposed by the public API.
queriedVin	string	The VIN that produced this record, when looked up by VIN.
observedAt	string	ISO 8601 timestamp of collection.

Complaints mode (dataset: "complaints"):

Field	Type	Description
odiNumber	string	NHTSA ODI complaint number.
make, model, modelYear	string	Vehicle identity.
products	object[]	Vehicles named in the complaint (type, make, model, modelYear, manufacturer).
component	string	Components cited in the complaint.
summary	string	Consumer narrative.
crash, fire	boolean	Whether a crash or fire was reported.
numberOfInjuries, numberOfDeaths	integer	Injuries and deaths reported.
dateOfIncident, dateComplaintFiled	string	Dates (YYYY-MM-DD).
vin	string	VIN when the complainant provided one.

Paid enrichment add-ons

Recalls mode only. These enrich each recall with data from other NHTSA APIs and are billed as the details event (one charge per enriched recall), only when real data is returned, for paying users. Free runs return recalls only.

• includeComplaintsSummary adds complaintsSummary per recall: total, crashCount, fireCount, totalInjuries, totalDeaths, topComponents, earliestIncidentDate, latestComplaintDate.
• includeSafetyRatings adds safetyRatings (NCAP star ratings per body-style variant: overall, front, side, rollover, plus crash-test photo/video URLs and ESC / forward-collision / lane-departure availability), and investigationCount, complaintsCount, recallsCount for the vehicle.

Example enriched fields returned for the 2020 Honda Accord:

{
  "complaintsSummary": { "total": 355, "crashCount": 14, "fireCount": 2, "totalInjuries": 11, "totalDeaths": 1, "topComponents": ["FORWARD COLLISION AVOIDANCE (100)", "ENGINE (70)"], "latestComplaintDate": "2026-08-27" },
  "safetyRatings": [ { "vehicleDescription": "2020 Honda ACCORD 4 DR FWD", "overallRating": "5", "rolloverRating": "5", "frontCrashPicture": "https://static.nhtsa.gov/crashTest/images/2020/v10191P080.jpg" } ],
  "investigationCount": 1,
  "complaintsCount": 355,
  "recallsCount": 5
}

How we compare

Capability	This actor	Typical NHTSA recall actors
Recalls by make / model / year	Yes	Yes
Recalls by campaign number	Yes	Some
Recalls by VIN (auto-decoded)	Yes	Rare
Component filter	Yes	Rare
Consumer complaints dataset	Yes	Some
Units affected on every recall	Yes	Rare
Do-not-drive / park-outside / OTA flags	Yes	Some
Raw and normalized recall date	Yes	Rare
Complaint summary add-on	Yes	No
NCAP safety ratings + investigation count add-on	Yes	No
No API key, no browser	Yes	Varies

We accept every input the popular NHTSA recall actors accept (make, model, year, VIN, campaign number, component, max) and return every field they return, plus units affected, advisory flags, direct recall links and optional complaint / safety-rating enrichment.

Run via API and CLI

Replace <TOKEN> with your Apify API token.

Run synchronously and get dataset items in one call:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~nhtsa-recalls-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"dataset":"recalls","makes":["Toyota"],"models":["Camry"],"modelYears":["2021","2022"],"maxRecalls":25}'

Look up by campaign number:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~nhtsa-recalls-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"campaignNumbers":["20V505000"]}'

Apify CLI:

apify call scrapers_lat/nhtsa-recalls-scraper \
  --input '{"dataset":"recalls","makes":["Honda"],"models":["Accord"],"modelYears":["2020"]}'

Fetch results

Every run writes to a dataset. Fetch items as JSON, CSV, or Excel by changing format:

# JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

# CSV
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

<DATASET_ID> is defaultDatasetId in the run object. Use offset and limit to page through large result sets.

Billing and limits

• Pay per result. You are charged per record returned (result event). See the pricing tab.
• Paid add-ons. includeComplaintsSummary and includeSafetyRatings are billed as the details event, one charge per enriched recall, only when real enrichment is returned, for paying users.
• No charge on failure. If a run errors, the actor writes a single item with a populated error field and does not charge for it. Empty runs cost nothing.
• Spend cap respected. Set maxTotalChargeUsd on the run; once reached, the actor stops emitting and charging.
• Free Apify plans are capped at 10 records per run. Upgrade for higher maxRecalls.

FAQ and troubleshooting

A run returned 0 records. Why? NHTSA has no recalls or complaints for that exact make, model and year, or the spelling did not match. Zero-result runs are not charged.

Can I look up recalls by VIN? Yes. Put VINs in vins; each is decoded to make, model and year, then queried. To decode full vehicle specifications from a VIN, see our NHTSA VIN Decoder Scraper.

What do parkIt and parkOutSide mean? parkIt true is NHTSA's do-not-drive advisory. parkOutSide true means park away from structures due to fire risk. Both come straight from NHTSA.

Why is reportReceivedDate different from reportReceivedDateRaw? reportReceivedDate is a normalized YYYY-MM-DD date; reportReceivedDateRaw is the exact string NHTSA returned, kept for transparency.

Does it get open investigations? NHTSA does not expose an investigations list through its public JSON API, but the safety-ratings add-on returns the open-investigation count for the vehicle.

Is this an official NHTSA tool? No. This actor is independent and not affiliated with NHTSA. It reads only publicly available NHTSA data. Use it in accordance with NHTSA's terms.

Related scrapers

• NHTSA VIN Decoder Scraper: decode vehicle specs from a VIN.
• TrueCar Listings Scraper: US used and new car listings from TrueCar.
• FMCSA Carriers Scraper: US motor carrier records.
• CPSC Recalls Scraper: US consumer product safety recalls.
• openFDA Food Recalls Scraper: US FDA food recall enforcement records.
• FDA Drug & Device Recalls Scraper: US FDA drug and device recalls.

More scrapers at scrapers.lat

Built and maintained by scrapers.lat, where we publish scrapers for US and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at scrapers.lat.

---

Independent tool, not affiliated with NHTSA. Accesses only publicly available NHTSA data. Use in accordance with NHTSA's terms of service.

---

NHTSA Scraper de Retiros (Recalls): API de Consulta de Retiros de Autos (Marca, Modelo, Año, VIN)

Consulta retiros oficiales de seguridad de vehículos de EE. UU. y quejas de consumidores de la base de datos de la NHTSA por marca, modelo y año, por VIN, o por número de campaña de retiro. Sin clave de API, sin cuenta en la NHTSA, sin navegador. Obtén números de campaña de retiro, componentes afectados, resúmenes del defecto, consecuencias, soluciones, unidades afectadas y avisos de no conducir / estacionar afuera, y opcionalmente enriquece cada retiro con estadísticas de quejas de consumidores y calificaciones de seguridad NCAP.

Aquí tienes un registro real de retiro, con cada campo base que devuelve el actor:

{
  "dataset": "recalls",
  "campaignNumber": "20V771000",
  "make": "HONDA",
  "model": "ACCORD",
  "modelYear": "2020",
  "component": "ELECTRICAL SYSTEM:BODY CONTROL MODULE:SOFTWARE",
  "summary": "Honda (American Honda Motor Co.) is recalling certain 2018-2020 Accord Sedan, Accord Hybrid, and 2019-2020 Insight vehicles. A software error may cause intermittent or continuous disruptions in communication between the Body Control Module (BCM) and other components.",
  "consequence": "Various system malfunctions such as inoperative windshield wipers, defroster, rearview camera, or exterior lighting can increase the risk of a crash.",
  "remedy": "Honda will notify owners, and dealers will update the BCM software, free of charge. Owners may contact Honda customer service at 1-888-234-2138.",
  "notes": "Owners may also contact the National Highway Traffic Safety Administration Vehicle Safety Hotline at 1-888-327-4236.",
  "manufacturer": "Honda (American Honda Motor Co.)",
  "reportReceivedDate": "2020-12-10",
  "reportReceivedDateRaw": "10/12/2020",
  "recallType": null,
  "potentialUnitsAffected": 737233,
  "parkIt": false,
  "parkOutSide": false,
  "overTheAirUpdate": false,
  "nhtsaRecallUrl": "https://www.nhtsa.gov/recalls?nhtsaId=20V771000",
  "associatedDocuments": null,
  "queriedVin": null,
  "observedAt": "2026-09-06T01:12:11.000Z",
  "error": null
}

📥 Entrada · 📤 Salida · 💰 Precios · ▶️ Ejemplos

Tabla de contenidos

• Qué hace
• Por qué este scraper
• Inicio rápido
• Referencia de entrada
• Referencia de salida
• Complementos de pago
• Cómo comparamos
• Uso vía API y CLI
• Obtener resultados
• Facturación y límites
• Preguntas frecuentes

Qué hace

Este es un scraper de retiros de la NHTSA y una API de consulta de retiros de autos para la base de datos de seguridad vehicular de EE. UU. Dale una lista de vehículos y escribe un registro normalizado por resultado en el dataset de la ejecución:

• Retiros por marca, modelo y año (modo recalls): campañas oficiales de retiro de seguridad del fabricante.
• Retiros por VIN: cada VIN de 17 caracteres se decodifica a marca, modelo y año, y luego se consulta.
• Retiros por número de campaña: consulta una campaña exacta de la NHTSA, por ejemplo 20V505000.
• Quejas de consumidores (modo complaints): quejas presentadas ante la NHTSA, incluidos choque, incendio, lesiones, muertes, fechas del incidente y VIN.

Las fechas se normalizan a YYYY-MM-DD (también se conserva la cadena original de la NHTSA), y los valores ausentes se devuelven como null, nunca inventados.

Por qué este scraper

• Cuatro formas de consultar: marca/modelo/año, VIN, número de campaña o un filtro de componente, en un solo actor.
• Unidades afectadas incluidas: se añade la población estimada de vehículos afectados a cada retiro, una cifra de escala que el feed por vehículo de la NHTSA no devuelve por sí solo.
• Avisos de no conducir y de estacionar afuera y banderas de actualización por aire (OTA) en cada retiro.
• Enriquecimiento opcional: adjunta estadísticas de quejas de consumidores y calificaciones de seguridad NCAP (con conteos de investigaciones abiertas) a cada retiro.
• Sin clave de API, sin navegador, datos públicos oficiales, exportados a JSON, CSV o Excel.

Inicio rápido

Abre el actor, pega esto en la entrada y presiona Run. Devuelve hasta 10 campañas de retiro de seguridad para el Honda Accord 2020.

{
  "dataset": "recalls",
  "makes": ["Honda"],
  "models": ["Accord"],
  "modelYears": ["2020"],
  "maxRecalls": 10
}

Consulta por número de campaña:

{ "campaignNumbers": ["20V505000"] }

Consulta por VIN:

{ "vins": ["1HGCV1F19LA000000"] }

Referencia de entrada

Campo	Tipo	Requerido	Descripción
dataset	enum	no	recalls (predeterminado) o complaints. Alias: dataType.
makes	string[]	una consulta requerida	Marcas de vehículo, por ejemplo Honda, Toyota, Ford. Sin distinción de mayúsculas. Alias: make.
models	string[]	una consulta requerida	Modelos, por ejemplo Accord, Camry, F-150. Alias: model.
modelYears	string[]	una consulta requerida	Años del modelo, por ejemplo 2020, 2021. Alias: modelYear, year.
campaignNumbers	string[]	una consulta requerida	Números de campaña de retiro de la NHTSA, por ejemplo 20V505000. Alias: campaignNumber.
vins	string[]	una consulta requerida	VIN de 17 caracteres, decodificados a marca/modelo/año y luego consultados. Alias: vin.
components	string[]	no	Conserva solo registros cuyo componente coincida con algún término, por ejemplo AIR BAGS. Sin distinción de mayúsculas.
includeComplaintsSummary	boolean	no	Complemento de pago. Adjunta un resumen de quejas a cada retiro.
includeSafetyRatings	boolean	no	Complemento de pago. Adjunta calificaciones de seguridad NCAP y conteo de investigaciones a cada retiro.
maxRecalls	integer	no	Máximo de registros en todas las consultas. Alias: maxItems, maxResults, maxRecords. Vacío significa todos.

Necesitas al menos uno de: marca + modelo + año del modelo, VIN, o números de campaña. El actor consulta cada combinación de marca x modelo x año del modelo que proporciones.

Referencia de salida

Un elemento del dataset por resultado. Los valores ausentes son null, nunca inventados.

Modo retiros (dataset: "recalls"):

Campo	Tipo	Descripción
campaignNumber	string	Número de campaña de retiro de la NHTSA, por ejemplo 20V771000.
make, model, modelYear	string	Identidad del vehículo.
component	string	Componente o sistema afectado.
summary	string	Resumen narrativo del defecto retirado.
consequence	string	Consecuencia de seguridad del defecto.
remedy	string	Solución del fabricante e información de contacto del propietario.
notes	string	Notas adicionales de la NHTSA.
manufacturer	string	Nombre del fabricante.
reportReceivedDate	string	Fecha en que la NHTSA recibió el informe de retiro (YYYY-MM-DD).
reportReceivedDateRaw	string	La cadena de fecha original de la NHTSA, tal como se devuelve.
recallType	string	Tipo de retiro cuando está presente, si no null (no expuesto por este feed).
potentialUnitsAffected	integer	Número estimado de vehículos afectados.
parkIt	boolean	true cuando la NHTSA aconseja no conducir el vehículo hasta repararlo (aviso de no conducir).
parkOutSide	boolean	true cuando la NHTSA aconseja estacionar afuera por riesgo de incendio.
overTheAirUpdate	boolean	true cuando la solución es una actualización por aire.
nhtsaRecallUrl	string	Enlace directo al retiro en nhtsa.gov.
associatedDocuments	null	Las URL de documentos no las expone la API pública.
queriedVin	string	El VIN que produjo este registro, cuando se consulta por VIN.
observedAt	string	Marca de tiempo ISO 8601 de la recopilación.

Modo quejas (dataset: "complaints"):

Campo	Tipo	Descripción
odiNumber	string	Número de queja ODI de la NHTSA.
make, model, modelYear	string	Identidad del vehículo.
products	object[]	Vehículos nombrados en la queja (type, make, model, modelYear, manufacturer).
component	string	Componentes citados en la queja.
summary	string	Narrativa del consumidor.
crash, fire	boolean	Si se reportó un choque o un incendio.
numberOfInjuries, numberOfDeaths	integer	Lesiones y muertes reportadas.
dateOfIncident, dateComplaintFiled	string	Fechas (YYYY-MM-DD).
vin	string	VIN cuando el reclamante lo proporcionó.

Complementos de pago

Solo en modo retiros. Estos enriquecen cada retiro con datos de otras APIs de la NHTSA y se facturan como el evento details (un cargo por retiro enriquecido), solo cuando se devuelven datos reales, para usuarios de pago. Las ejecuciones gratuitas devuelven solo retiros.

• includeComplaintsSummary agrega complaintsSummary por retiro: total, crashCount, fireCount, totalInjuries, totalDeaths, topComponents, earliestIncidentDate, latestComplaintDate.
• includeSafetyRatings agrega safetyRatings (calificaciones de estrellas NCAP por variante de carrocería: general, frontal, lateral, vuelco, más URL de fotos/videos de pruebas de choque y disponibilidad de ESC / alerta de colisión frontal / alerta de cambio de carril), y investigationCount, complaintsCount, recallsCount para el vehículo.

Ejemplo de campos enriquecidos devueltos para el Honda Accord 2020:

{
  "complaintsSummary": { "total": 355, "crashCount": 14, "fireCount": 2, "totalInjuries": 11, "totalDeaths": 1, "topComponents": ["FORWARD COLLISION AVOIDANCE (100)", "ENGINE (70)"], "latestComplaintDate": "2026-08-27" },
  "safetyRatings": [ { "vehicleDescription": "2020 Honda ACCORD 4 DR FWD", "overallRating": "5", "rolloverRating": "5", "frontCrashPicture": "https://static.nhtsa.gov/crashTest/images/2020/v10191P080.jpg" } ],
  "investigationCount": 1,
  "complaintsCount": 355,
  "recallsCount": 5
}

Cómo comparamos

Capacidad	Este actor	Actores típicos de retiros NHTSA
Retiros por marca / modelo / año	Sí	Sí
Retiros por número de campaña	Sí	Algunos
Retiros por VIN (decodificado automáticamente)	Sí	Poco común
Filtro de componente	Sí	Poco común
Dataset de quejas de consumidores	Sí	Algunos
Unidades afectadas en cada retiro	Sí	Poco común
Banderas de no conducir / estacionar afuera / OTA	Sí	Algunos
Fecha de retiro original y normalizada	Sí	Poco común
Complemento de resumen de quejas	Sí	No
Complemento de calificaciones NCAP + conteo de investigaciones	Sí	No
Sin clave de API, sin navegador	Sí	Varía

Aceptamos cada entrada que aceptan los actores populares de retiros NHTSA (marca, modelo, año, VIN, número de campaña, componente, máximo) y devolvemos cada campo que ellos devuelven, además de unidades afectadas, banderas de aviso, enlaces directos al retiro y enriquecimiento opcional de quejas / calificaciones de seguridad.

Uso vía API y CLI

Reemplaza <TOKEN> con tu token de API de Apify.

Ejecuta de forma síncrona y obtén los elementos del dataset en una sola llamada:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~nhtsa-recalls-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"dataset":"recalls","makes":["Toyota"],"models":["Camry"],"modelYears":["2021","2022"],"maxRecalls":25}'

Consulta por número de campaña:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~nhtsa-recalls-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"campaignNumbers":["20V505000"]}'

Apify CLI:

apify call scrapers_lat/nhtsa-recalls-scraper \
  --input '{"dataset":"recalls","makes":["Honda"],"models":["Accord"],"modelYears":["2020"]}'

Obtener resultados

Cada ejecución escribe en un dataset. Obtén los elementos como JSON, CSV o Excel cambiando format:

# JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

# CSV
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

<DATASET_ID> es defaultDatasetId en el objeto de la ejecución. Usa offset y limit para paginar conjuntos grandes.

Facturación y límites

• Pago por resultado. Se cobra por registro devuelto (evento result). Consulta la pestaña de precios.
• Complementos de pago. includeComplaintsSummary e includeSafetyRatings se facturan como el evento details, un cargo por retiro enriquecido, solo cuando se devuelve enriquecimiento real, para usuarios de pago.
• Sin cargo por fallo. Si una ejecución falla, el actor escribe un solo elemento con el campo error y no cobra por él. Las ejecuciones vacías no cuestan nada.
• Se respeta el límite de gasto. Configura maxTotalChargeUsd en la ejecución; al alcanzarlo, el actor deja de emitir y cobrar.
• Los planes gratuitos de Apify están limitados a 10 registros por ejecución. Mejora tu plan para un maxRecalls mayor.

Preguntas frecuentes

Una ejecución devolvió 0 registros. ¿Por qué? La NHTSA no tiene retiros o quejas para esa marca, modelo y año exactos, o la ortografía no coincidió. Las ejecuciones sin resultados no se cobran.

¿Puedo consultar retiros por VIN? Sí. Pon los VIN en vins; cada uno se decodifica a marca, modelo y año, y luego se consulta. Para decodificar las especificaciones completas del vehículo desde un VIN, consulta nuestro NHTSA VIN Decoder Scraper.

¿Qué significan parkIt y parkOutSide? parkIt en true es el aviso de no conducir de la NHTSA. parkOutSide en true significa estacionar lejos de estructuras por riesgo de incendio. Ambos vienen directamente de la NHTSA.

¿Por qué reportReceivedDate difiere de reportReceivedDateRaw? reportReceivedDate es una fecha normalizada YYYY-MM-DD; reportReceivedDateRaw es la cadena exacta que devolvió la NHTSA, conservada por transparencia.

¿Obtiene investigaciones abiertas? La NHTSA no expone una lista de investigaciones a través de su API pública JSON, pero el complemento de calificaciones de seguridad devuelve el conteo de investigaciones abiertas del vehículo.

¿Es una herramienta oficial de la NHTSA? No. Este actor es independiente y no está afiliado a la NHTSA. Lee solo datos disponibles públicamente de la NHTSA. Úsalo de acuerdo con los términos de la NHTSA.

---

Herramienta independiente, no afiliada a la NHTSA. Accede solo a datos disponibles públicamente de la NHTSA. Úsala de acuerdo con los términos de servicio de la NHTSA.