Bedrijfsdata icon

Bedrijfsdata

Get data from the Bedrijfsdata API.

Actions30

Overview

The "Get Parameter Suggestions" operation of the Company resource in this node fetches valid filter suggestions for various company-related fields from the Bedrijfsdata API. It helps users by providing autocomplete-like suggestions based on partial input queries, which can be used to refine searches or filters when retrieving company data.

Common scenarios where this node is beneficial include:

  • Assisting users in selecting valid keywords or technologies when searching for companies.
  • Providing city name suggestions limited to Dutch cities to ensure accurate geographic filtering.
  • Suggesting domain names related to companies for domain-based queries.

Practical example:

  • A user wants to find companies using a specific technology framework but only knows part of its name. By entering the first few letters, the node returns matching technology suggestions to choose from, improving search accuracy.

Properties

Name Meaning
Suggestion Type Selects the field to get suggestions for. Options: Keywords (Text), Technology Apps (Apps), City (City, NL Only), Domain Names (Domain)
Search Query The query string to fetch suggestions for. Usually 2-4 starting letters suffice to get relevant results.
Output as Individual Items Boolean flag to output each suggestion as an individual item instead of a single aggregated response.

Output

The node outputs JSON data containing the list of suggested values corresponding to the selected suggestion type and query. The structure typically includes an array of suggestion terms.

If "Output as Individual Items" is enabled, each suggestion is returned as a separate item in the output stream, facilitating further processing or iteration in workflows.

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to the Bedrijfsdata API with a valid API key credential configured in n8n.
  • The node makes HTTP GET requests to the /suggest endpoint of the Bedrijfsdata API.
  • No additional environment variables are required beyond the API authentication setup.

Troubleshooting

  • Common issues:

    • Empty or no suggestions returned: Ensure the search query (q) is at least 2 characters long and matches existing data.
    • API request failures: Check that the API key credential is correctly configured and has sufficient permissions.
    • Network errors: Verify internet connectivity and that the Bedrijfsdata API service is reachable.

  • Error messages:

    • "Failed to fetch cities: <message>" or "Error fetching cities: <message>": Indicates problems specifically when fetching city suggestions; check query validity and API status.
    • General API errors will be surfaced as node operation errors with descriptive messages; reviewing these messages helps identify misconfigurations or invalid inputs.

Links and References

Discussion