Bedrijfsdata icon

Bedrijfsdata

Get data from the Bedrijfsdata API.
Join our community

Actions31

Overview

This node interacts with the Bedrijfsdata API to retrieve employee data for a specific company identified by its Bedrijfsdata.nl ID. It is designed to fetch many employees associated with a company, optionally filtered by a search query. This functionality is useful in scenarios where you need detailed personnel information from Dutch companies, such as for HR analytics, recruitment, compliance checks, or business intelligence.

For example, you could use this node to:

  • Retrieve all employees of a company to analyze workforce size and composition.
  • Filter employees by name or role using the search query to find specific individuals.
  • Obtain metadata about the query results, like total number of employees found and credit usage, by enabling detailed output.

Properties

Name Meaning
Bedrijfsdata.nl ID (Required) The unique identifier of the company whose employees you want to retrieve.
Search Query (Optional) A text string to filter employees by. Use this to narrow down results based on GDPR compliance.
Detailed Output (Optional) Boolean flag to include additional details such as total people found and credit usage. When enabled, returns a single item instead of an array.

Output

The node outputs JSON data representing the employees of the specified company. By default, it returns an array of employee objects containing relevant employee information as provided by the API.

If the "Detailed Output" property is enabled, the output changes to a single JSON object that includes metadata fields such as the total number of employees found and credit usage statistics, rather than an array of employees.

The node does not output binary data.

Dependencies

  • Requires an active connection to the Bedrijfsdata API.
  • Requires an API key credential configured in n8n for authentication with the Bedrijfsdata service.
  • The base URL used for requests is https://api.bedrijfsdata.nl/v1.2.
  • No other external dependencies are required.

Troubleshooting

  • Missing or invalid Bedrijfsdata.nl ID: The node requires a valid company ID. Ensure the ID is correct and corresponds to an existing company in the Bedrijfsdata database.
  • Empty or no results returned: If the search query is too restrictive or the company has no employees listed, the result may be empty. Try broadening or removing the search query.
  • API authentication errors: Verify that the API key credential is correctly set up and has sufficient permissions.
  • Rate limiting or quota exceeded: The API may limit the number of requests or credits used. If you receive errors related to quota, check your subscription and usage limits.
  • Unexpected API response: Network issues or API changes might cause unexpected responses. Check the API status and update the node if necessary.

Links and References

Discussion