BrasilAPI FIPE
AI-generatedOverview
This node allows querying vehicle data from the FIPE table using the BrasilAPI service. It supports fetching information about vehicle brands, models, model years, and prices for different types of vehicles such as cars, motorcycles, and trucks. This is useful for applications that need up-to-date vehicle pricing or specification data in Brazil, such as automotive marketplaces, insurance platforms, or vehicle valuation tools.
Practical examples:
- Retrieve a list of all car brands available in the FIPE database.
- Get all models for a specific motorcycle brand.
- Fetch available model years for a given truck model.
- Obtain the current price of a specific car model year.
Properties
| Name | Meaning |
|---|---|
| Tipo de consulta | Type of query to perform on FIPE: "Marcas" (brands), "Modelos" (models), "Anos" (years), "Preço" (price) |
| Tipo de veículo | Vehicle category: "Carro" (car), "Moto" (motorcycle), "Caminhão" (truck) |
| Código da Marca | Brand code identifier (string). Required for queries other than "Marcas". |
| Código do Modelo | Model code identifier (string). Required for queries "Anos" and "Preço". |
| Ano Modelo | Model year (string). Required only for "Preço" query. |
Output
The node outputs an array with one item per input. Each item contains a json field with the response data from the BrasilAPI FIPE endpoint:
- For "Marcas": JSON array of vehicle brands.
- For "Modelos": JSON object listing models for the specified brand.
- For "Anos": JSON array of available model years for the specified model.
- For "Preço": JSON object containing price information for the specified vehicle model and year.
If an error occurs during the HTTP request, the output JSON will contain an error field with the error message along with the parameters used (tipo, veiculo, codigoMarca, codigoModelo, anoModelo) for easier debugging.
The node does not output binary data.
Dependencies
- Requires internet access to call the public BrasilAPI endpoints.
- No API key or authentication is needed.
- Uses standard HTTP GET requests to URLs constructed based on input parameters.
Troubleshooting
Common issues:
- Missing required parameters for certain query types (e.g.,
codigoMarcamissing when querying models). - Invalid or non-existent codes leading to 404 or empty responses.
- Network connectivity problems preventing API calls.
- Missing required parameters for certain query types (e.g.,
Error messages:
- The node returns an error message inside the output JSON under the
errorproperty if the HTTP request fails. - Check that all required parameters are correctly set according to the selected query type.
- Verify network connectivity and API availability.
- The node returns an error message inside the output JSON under the
Links and References
- BrasilAPI FIPE documentation: https://brasilapi.com.br/docs#tag/FIPE
- FIPE Table official site (for reference): https://veiculos.fipe.org.br/