Imobzi icon

Imobzi

Interagir com a API da Imobzi
Join our community

Actions62

Overview

This node integrates with the Imobzi API to interact with real estate-related data. Specifically, for the Imovel (property) resource and the Get Many operation, it retrieves multiple property records from Imobzi based on optional filters, ordering, pagination limits, and offsets.

Typical use cases include:

  • Fetching a list of properties that match certain criteria (e.g., properties in a specific location or with a price range).
  • Retrieving paginated property data for reporting or synchronization purposes.
  • Ordering property results by a specific field such as title or creation date.

Example: You want to get up to 50 properties where the "status" field equals "available", ordered by "title".

Properties

Name Meaning
Filtros A collection of filter conditions to narrow down the properties returned. Each filter includes:
- Campo Name or ID: The property field to filter by (loaded dynamically).
- Operador: Comparison operator:
  • Começa Com (starts_with)
  • Contém (contains)
  • Diferente (neq)
  • Igual (eq)
  • Maior Ou Igual (gte)
  • Maior Que (gt)
  • Menor Ou Igual (lte)
  • Menor Que (lt)
  • Não Contém (not_contains)
  • Termina Com (ends_with)
- Valor: The value to compare against.
Order By Field name to order the results by (string).
Limit Maximum number of property records to return (number, minimum 1, default 50).
Offset Number of items to skip before starting to collect the result set (number, minimum 0, default 0).

Output

The output is an array of JSON objects, each representing a property record retrieved from Imobzi. The structure corresponds directly to the Imobzi API's property data schema, including all fields available for a property.

Example output snippet:

[
  {
    "id": 123,
    "title": "Beautiful Apartment Downtown",
    "status": "available",
    "price": 350000,
    ...
  },
  {
    "id": 124,
    "title": "Cozy Cottage",
    "status": "sold",
    "price": 250000,
    ...
  }
]

No binary data is output by this operation.

Dependencies

  • Requires an active connection to the Imobzi API via an API key credential configured in n8n.
  • The node uses authenticated HTTP requests to the Imobzi endpoints.
  • No additional external dependencies beyond the Imobzi API and n8n's HTTP request helper.

Troubleshooting

  • Unsupported Resource Error: If you select a resource not supported by the node, it will throw an error like Recurso "X" não suportado!. Ensure you select "Imovel" (property) for this operation.
  • Operation Not Supported: Selecting an unsupported operation will cause an error Operação "X" não suportada!.
  • Invalid Filter Fields: Filters must use valid property fields. Using incorrect field names may result in empty results or API errors.
  • API Authentication Errors: If the API key is missing or invalid, requests will fail. Verify your Imobzi API credentials in n8n.
  • Rate Limits or Network Issues: Network failures or rate limiting by Imobzi can cause request failures. Implement retry logic or check API usage limits if needed.
  • Empty Results: If no properties match the filters, the output will be an empty array.

Links and References

Discussion