Hudu icon

Hudu

Interact with Hudu REST API

Company → Get Many

AI-generated

Overview

This node operation retrieves multiple company records from the Hudu API. It supports filtering companies by various criteria such as city, name, phone number, state, website, and update date ranges. Users can choose to return all matching results or limit the number of results returned. Additionally, the results can be wrapped into a single item containing an array of companies and a count, which helps prevent downstream nodes from executing once per result item, reducing the risk of rate limiting.

Use Case Examples

  1. Retrieve all companies located in a specific city.
  2. Get up to 25 companies updated within the last 7 days.
  3. Search companies by name or phone number with a limit on the number of results.
  4. Return all companies as a single item with an 'items' array and a 'count' field to optimize workflow execution.

Properties

Name Meaning
Return All Whether to return all matching company results or only up to a specified limit.
Limit Maximum number of company results to return when 'Return All' is false.
Wrap Results in Single Item Whether to return all results as a single item containing an 'items' array and a 'count' field. This helps prevent downstream nodes from executing once per result item, which can cause rate limiting issues.
Filters Collection of filters to narrow down the company results based on various fields.

Output

JSON

  • items - Array of company objects returned when results are wrapped in a single item.
  • count - Number of company objects returned when results are wrapped in a single item.
  • * - Individual company objects returned as separate items when results are not wrapped.

Dependencies

  • Hudu REST API
  • API key credential for authentication

Troubleshooting

  • If no companies are returned, check the filter criteria to ensure they match existing company data.
  • If the node throws an error about an unknown resource, verify that the resource parameter is set to 'companies'.
  • Rate limiting errors may occur if many individual company items are returned and processed downstream; use the 'Wrap Results in Single Item' option to mitigate this.
  • Ensure the API key credential is valid and has the necessary permissions to access company data.

Discussion