Bedrijfsdata icon

Bedrijfsdata

Get data from the Bedrijfsdata API.

Actions30

Overview

This node operation retrieves multiple company profiles from the Bedrijfsdata API with advanced filtering options. It is designed to query a comprehensive Dutch business database, allowing users to search for companies based on various criteria such as location, industry, size, social media presence, and more.

Common scenarios where this node is beneficial:

  • Market research to identify companies fitting specific profiles.
  • Lead generation by filtering companies with certain attributes or technologies.
  • Competitive analysis by retrieving detailed company data.
  • Data enrichment workflows that require bulk company information retrieval.

Practical example:
A marketing team wants to find all companies in The Netherlands with 10 to 50 employees, operating in the technology sector, and having an active LinkedIn presence. They can configure this node to filter by employee range, industry codes, and social media filters to get a tailored list of companies matching these criteria.

Properties

Name Meaning
Country The country to search companies in. Currently only "The Netherlands" (nl) is supported.
Detailed Output Whether to return detailed metadata such as total number of companies found and credit usage. When enabled, returns a single item with summary details instead of an array of companies.
Results Breakdown When detailed output is enabled, add breakdowns of results by categories like Apps Categories, Data Availability, Number of Employees, Organization Type, Province, Revenue, and SBI (industry classification).
Filter in JSON Use JSON format to specify complex filter queries instead of individual parameters. Recommended for AI agents and power users.
JSON Query Advanced JSON input for filter options when "Filter in JSON" is enabled. Supports complex Solr operators like AND, OR, parentheses, etc. Keys correspond to API parameters such as name, city, coc, etc.
Search Specific Companies/groups Filters to search for specific companies or groups by unique identifiers such as Bedrijfsdata.nl ID, Chamber of Commerce number, company name, domain name(s), trade names, or VAT number.
Basic Filters Filters based on basic company attributes including data availability (address, email, phone, URL, VAT), estimated number of employees, office type (headquarters or branch), organization type, revenue, and year founded.
Keyword Filters Search companies by keywords appearing in industries, activities, names, or website content. Includes required keywords (AND), optional keywords (OR), and exclude keywords (NOT).
Industry (SBI) Filters Include or exclude companies by their SBI industry codes (Dutch standard classification).
Location Filters Search companies by registration address details such as address ID, city, coordinates (latitude/longitude), distance radius, location name, postcode, and province.
Technology Filters Filter companies by apps they use, either including or excluding specific applications.
Social Media Filters Filter companies by presence on social media channels (Facebook, Instagram, LinkedIn, Pinterest, Twitter, YouTube) and by social interactions (likes received).
Review Filters Filter companies by average review rating and number of reviews.
Linkpartner Filters Search companies by domains they link to, domains linking to them, or domains mentioning their company name. Useful for finding partners.
Web Rank Filters Filter companies by web ranking metrics such as DomCop Pagerank, Crux Rank, and Tranco Rank.
Pagination Options Control pagination of results by specifying number of results per page, page number, or offset of results to skip.

Output

  • The main output is a JSON array of company profile objects matching the specified filters.
  • If "Detailed Output" is enabled, the output is a single JSON object containing metadata such as:
    • Total number of companies found.
    • Credit usage information.
    • Optional facets breakdown by categories like apps, employees, revenue, etc.
  • No binary data output is indicated for this operation.

Dependencies

  • Requires an API key credential for authenticating requests to the Bedrijfsdata API.
  • The node uses HTTP GET requests to the /companies endpoint of the Bedrijfsdata API.
  • The base URL for API requests is https://api.bedrijfsdata.nl/v1.2.
  • Proper configuration of the API key credential in n8n is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing API key credential will cause authentication errors.
    • Incorrect filter parameter formats (e.g., malformed ranges like 5:10 or invalid JSON in the JSON Query) may result in API errors.
    • Using incompatible combinations of filters (e.g., specifying both city and coordinates with distance) might lead to unexpected results or API rejections.
    • Requesting detailed output but expecting an array of companies can confuse downstream processing since it returns a single summary object.

  • Error messages:

    • Authentication failures typically indicate invalid or missing API credentials.
    • API response errors may include messages about invalid query parameters; verify filter syntax and allowed values.
    • Network or timeout errors suggest connectivity issues; check internet access and API service status.

  • Resolutions:

    • Ensure the API key credential is correctly set up and has sufficient permissions.
    • Validate filter inputs carefully, especially JSON queries.
    • Consult the API documentation for correct parameter usage.
    • Use pagination options to limit large result sets and avoid timeouts.

Links and References

If you need further details on other operations or resources, feel free to ask!

Discussion