Bedrijfsdata icon

Bedrijfsdata

Get data from the Bedrijfsdata API.

Actions30

Overview

This node operation, Get Many Employees under the Data (Advanced) resource, retrieves employee data for a specific company identified by its Bedrijfsdata.nl ID. It is useful when you want to obtain detailed personnel information about a company, such as for HR analytics, market research, or compliance checks.

Typical use cases include:

  • Fetching a list of employees working at a particular company.
  • Filtering employees based on a search query to narrow down results.
  • Optionally retrieving detailed metadata about the query result, including total number of employees found and credit usage.

For example, you might use this node to get all employees of a client company to analyze team size or roles, or to verify employment details during due diligence.

Properties

Name Meaning
Bedrijfsdata.nl ID (Required) The unique identifier of the company whose employees you want to retrieve.
Search Query (Optional) A text filter to refine the employee search results. Use this to comply with GDPR specificity requirements.
Detailed Output (Optional, boolean) If enabled, returns detailed metadata such as total people found and credit usage instead of the employee array.

Output

The node outputs JSON data containing employee information retrieved from the API:

  • By default, it returns an array of employee objects, each representing an individual employee associated with the specified company.
  • If Detailed Output is enabled, the output contains a single object with additional metadata fields like total count of employees found and credit usage statistics, rather than an array.

No binary data output is involved in this operation.

Dependencies

  • Requires an API key credential for authenticating requests to the Bedrijfsdata.nl API.
  • The node makes HTTP GET requests to the /people endpoint of the Bedrijfsdata.nl API version 1.2.
  • Proper configuration of the API base URL (https://api.bedrijfsdata.nl/v1.2) and credentials within n8n is necessary.

Troubleshooting

  • Missing or invalid Bedrijfsdata.nl ID: The id property is required. Omitting it or providing an incorrect ID will cause the API request to fail or return no results.
  • Empty or overly broad search queries: Using vague or empty search queries may return large datasets or irrelevant results. Use specific filters to comply with GDPR and improve performance.
  • Detailed Output returns a single item: Enabling the Detailed Output option changes the response structure from an array to a single object. Downstream nodes expecting an array may need adjustment.
  • API authentication errors: Ensure the API key credential is correctly set up and has sufficient permissions.
  • Rate limits or quota exceeded: The API may enforce usage limits; monitor credit usage especially when requesting detailed output.

Links and References

Discussion