Bedrijfsdata icon

Bedrijfsdata

Get data from the Bedrijfsdata API.

Overview

The "Get Many Vacancies" operation of the Bedrijfsdata node retrieves multiple job vacancy listings for a specified company using its unique Bedrijfsdata.nl ID. This operation is useful for users who want to monitor or analyze open positions within a company, automate recruitment workflows, or integrate vacancy data into HR or business intelligence systems.

Practical examples include:

  • Automatically fetching all current vacancies from a company’s profile to display on a careers page.
  • Integrating vacancy data into an applicant tracking system (ATS) for streamlined hiring.
  • Monitoring competitors’ job openings for market research.

Properties

Name Meaning
Bedrijfsdata.nl ID (Required) The unique identifier of the company in the Bedrijfsdata.nl database for which vacancies are retrieved.
Search Query (Optional) A text query to filter vacancies by keywords, allowing retrieval of specific types of job openings.
Detailed Output (Optional) Boolean flag indicating whether to return detailed metadata such as total number of vacancies found and credit usage. When enabled, the output contains a single item with summary details instead of an array of vacancies.

Output

  • The main output is a JSON object or array containing vacancy data related to the specified company.
  • If Detailed Output is false or not set, the output is an array of vacancy items, each representing a job opening with relevant fields (e.g., title, description, location).
  • If Detailed Output is true, the output is a single JSON object containing metadata about the vacancies, such as the total count and API credit usage, rather than the list of vacancies.
  • The node does not output binary data.

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 /vacancies endpoint of the Bedrijfsdata API.
  • No additional external dependencies beyond the API access.

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 malformed search query: Providing an invalid search query may result in no matching vacancies.
  • API rate limits or quota exceeded: The API may limit the number of requests or credits used. Enabling detailed output can help monitor credit usage.
  • Network or authentication errors: Ensure the API key credential is valid and network connectivity to the Bedrijfsdata API is available.
  • Unexpected API responses: If the API returns unexpected data or errors, verify the parameters and consult the Bedrijfsdata API documentation.

Links and References

Discussion