Bedrijfsdata icon

Bedrijfsdata

Get data from the Bedrijfsdata API.
Join our community

Actions31

Overview

This node interacts with the Bedrijfsdata API to retrieve parameter suggestions related to companies. Specifically, the "Get Parameter Suggestions" operation fetches valid filter values for various fields used in company searches, such as keywords, technologies (apps and frameworks), cities (limited to the Netherlands), and domain names.

This functionality is useful when building dynamic search filters or autocomplete inputs in workflows that query company data. For example, if you want to provide users with suggested keywords or city names as they type, this node can supply relevant options based on partial input queries.

Practical examples:

  • Suggesting technology tags (like React, Angular) when filtering companies by their tech stack.
  • Providing city name suggestions limited to Dutch cities to refine location-based company searches.
  • Offering domain name completions to help identify companies by their web presence.

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 text query to fetch suggestions for. Usually 2-4 letters are enough 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 emitted as a separate item in the workflow, facilitating further processing or filtering downstream.

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to the Bedrijfsdata API via an API key credential configured in n8n.
  • The node makes HTTP GET requests to the /suggest endpoint of the Bedrijfsdata API.
  • Network access to https://api.bedrijfsdata.nl/v1.2 must be available.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Network connectivity problems may prevent reaching the API endpoint.
    • Providing an empty or too short search query might return no suggestions.
    • Selecting a suggestion type not supported by the API could result in errors.

  • Error messages:

    • "Failed to fetch cities: <message>" indicates the API returned an error or unexpected response when fetching city suggestions.
    • "Error fetching cities: <message>" signals a network or request failure during the city suggestions retrieval.

    Similar error patterns apply for other suggestion types, replacing "cities" with the relevant context.

  • Resolutions:

    • Verify API credentials and permissions.
    • Ensure the search query is sufficiently long (at least 2 characters).
    • Check network connectivity and firewall settings.
    • Confirm the suggestion type is valid and supported.

Links and References

Discussion