Brasil API icon

Brasil API

Consulta endpoints públicos da BrasilAPI
Join our community

Actions24

Overview

This node integrates with BrasilAPI, a public API service providing various Brazilian data endpoints. Specifically for the "FIPE – Marcas" operation under the "Default" resource, it fetches vehicle brand information from the FIPE database, which is widely used in Brazil for vehicle price reference and market data.

Use cases include:

  • Retrieving a list of vehicle brands for cars, motorcycles, or trucks.
  • Integrating vehicle brand data into applications related to automotive sales, insurance, or valuation.
  • Automating workflows that require up-to-date vehicle brand information from the official FIPE source.

Example: A car dealership automation could use this node to dynamically populate brand options when listing vehicles for sale.

Properties

Name Meaning
Tipo Veículo (carros,motos,caminhoes) The type of vehicle to query brands for. Options are: carros (cars), motos (motorcycles), caminhoes (trucks). Default is carros.
Extra Query (JSON) Optional additional filters as key-value pairs in JSON format to refine the API request.

Output

The node outputs an array of JSON objects representing the vehicle brands retrieved from the FIPE API. Each object typically contains details about a brand such as its name and identifier used by FIPE.

The output structure is:

[
  {
    "codigo": number,
    "nome": string
  },
  ...
]

Where:

  • codigo is the unique code identifying the brand.
  • nome is the brand's name.

No binary data is produced by this operation.

Dependencies

  • Requires internet access to call the BrasilAPI public endpoints.
  • No authentication or API keys are needed since BrasilAPI is publicly accessible.
  • Uses the HTTP client library internally to perform GET requests with a 10-second timeout.

Troubleshooting

  • Timeouts or network errors: Ensure the node has internet connectivity and the BrasilAPI service is reachable.
  • Unsupported operation error: This node only supports predefined operations; ensure "fipeMarcas" is selected.
  • Invalid JSON in Extra Query: If using the Extra Query property, ensure valid JSON syntax to avoid parsing errors.
  • Empty results: Verify the vehicle type parameter is correct (carros, motos, or caminhoes) and that the FIPE API has data for that category.

Links and References

Discussion