Brasil API icon

Brasil API

Consulta endpoints públicos da BrasilAPI

Overview

This node integrates with BrasilAPI, a public API service providing various Brazilian data endpoints. Specifically, the "FIPE – Veículos por Marca" operation fetches vehicle information by brand from the FIPE database, which is widely used in Brazil for vehicle price reference and details.

Use cases include:

  • Retrieving a list of vehicles for a given brand and vehicle type (cars, motorcycles, or trucks).
  • Building applications that need up-to-date vehicle model data for valuation, comparison, or inventory.
  • Automating workflows that require vehicle data lookup based on brand codes.

Example: Given a vehicle type "carros" and a brand code, the node returns all vehicle models under that brand, useful for car dealerships or insurance companies.

Properties

Name Meaning
Tipo Veículo (carros,motos,caminhoes) The type of vehicle to query. Options: "carros" (cars), "motos" (motorcycles), "caminhoes" (trucks). Used to filter the vehicle brand or model listings.
Código Marca Numeric code representing the vehicle brand. Required when fetching vehicles by brand.
Extra Query (JSON) Optional JSON object with key-value pairs for additional filters or query parameters.

Output

The node outputs an array of JSON objects corresponding to the API response for the selected operation.

For the "FIPE – Veículos por Marca" operation, the output JSON contains detailed information about vehicles under the specified brand and type, such as model names, years, and codes used by FIPE.

No binary data output is produced by this node.

Dependencies

  • Requires internet access to call BrasilAPI endpoints at https://brasilapi.com.br/api.
  • No special authentication is needed; the API is public.
  • The node uses the HTTP client library internally to perform GET requests with a 10-second timeout.

Troubleshooting

  • Timeouts or no response: Ensure network connectivity and that BrasilAPI is reachable. The node has a 10-second request timeout.
  • Unsupported operation error: Occurs if an invalid operation name is set. Verify the operation property matches one of the supported options.
  • Invalid brand code or vehicle type: If the API returns empty or error responses, check that the "Código Marca" and "Tipo Veículo" values are valid and correspond to existing FIPE data.
  • Malformed Extra Query JSON: Ensure the "Extra Query" field contains valid JSON syntax to avoid request errors.

Links and References

Discussion