Bedrijfsdata icon

Bedrijfsdata

Get data from the Bedrijfsdata API.
Join our community

Actions31

Overview

The "Company - Get Many" operation in this node allows users to retrieve multiple company profiles from the Bedrijfsdata API with advanced and highly customizable filtering options. It is designed for scenarios where you need to search, filter, and analyze large sets of company data based on various criteria such as location, industry, size, technology usage, social media presence, reviews, and more.

This operation is beneficial for:

  • Market research and competitive analysis by filtering companies based on specific attributes.
  • Lead generation by targeting companies that match detailed criteria.
  • Data enrichment workflows where bulk company data retrieval is needed.
  • Business intelligence applications requiring segmentation of companies by revenue, employees, or geography.

Practical examples:

  • Retrieve all companies in The Netherlands with more than 50 employees and a minimum revenue of €1 million.
  • Find companies using specific software apps or having a presence on LinkedIn and Twitter.
  • Get a detailed summary including total number of companies found and credit usage statistics.
  • Search companies located within a certain distance from given coordinates or in specific Dutch provinces.

Properties

Name Meaning
Country The country to search companies in. Currently only "The Netherlands" (nl) is supported.
Detailed Output Whether to return detailed output including metadata like total number of companies found and credit usage. Note: When enabled, returns a single item instead of an array of companies.
Results Breakdown When detailed output is enabled, add breakdowns of results by categories such as Apps Categories, Data Availability, Number of Employees, Organization Type, Province, Revenue, and SBI codes.
Filter in JSON Enable advanced JSON querying for filters, recommended for AI agents and power users.
JSON Query JSON input for complex filter queries using Solr operators (AND, OR, parentheses). Keys correspond to API parameters like name, city, coc, etc. Only shown if "Filter in JSON" is true.
Search Specific Companies/groups Collection of filters to search companies by unique identifiers such as Bedrijfsdata.nl ID, Chamber of Commerce number, company name, domain name(s), trade names, or VAT number.
Basic Filters Collection of basic attribute filters including data availability types (address, email, phone, URL, VAT), estimated number of employees (range), office type (headquarters or branch), organization type, revenue range, and year founded.
Keyword Filters Collection of keyword-based filters allowing required keywords (AND), optional keywords (OR), and excluded keywords (NOT) to refine company search based on industries, activities, names, and website content.
Industry (SBI) Filters Collection to include or exclude companies by their SBI industry codes (numeric codes without dots).
Location Filters Collection of filters for searching companies by registration address details such as address ID, city, coordinates (latitude/longitude), distance radius, location name, postcode, and province.
Technology Filters Collection to include or exclude companies based on the apps they use.
Social Media Filters Collection to filter companies by social media presence on platforms like Facebook, Instagram, LinkedIn, Pinterest, Twitter, YouTube, and by social interactions (likes received).
Review Filters Collection to filter companies by average review rating and number of reviews, supporting range queries.
Linkpartner Filters Collection to filter companies by domains they link to, domains linking to them, domains mentioning them, or combinations thereof—useful for finding partners.
Web Rank Filters Collection to filter companies by web ranking metrics such as DomCop Pagerank, Crux Rank, and Tranco Rank, supporting range queries.
Pagination Options Collection to control pagination: number of results per page, page number, or offset of results to skip before returning data.

Output

  • The main output is a JSON object or array containing company profile data matching the specified filters.
  • If "Detailed Output" is enabled, the output contains a single item with additional metadata fields such as total number of companies found and credit usage information, along with optional facets breakdown.
  • The structure of each company profile includes standard company attributes as returned by the Bedrijfsdata API.
  • No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating requests to the Bedrijfsdata API.
  • The node makes HTTP GET requests to the endpoint https://api.bedrijfsdata.nl/v1.2/companies with query parameters constructed from the input properties.
  • Proper configuration of the API key credential in n8n is necessary for successful execution.

Troubleshooting

  • Common issues:

    • Missing or invalid API key credential will cause authentication errors.
    • Providing invalid filter values or malformed JSON in the "JSON Query" property may result in API errors.
    • Using incompatible combinations of location filters (e.g., specifying both city and distance incorrectly) can cause request failures.
    • Requesting detailed output but expecting an array of companies may lead to confusion since only one item is returned.

  • Error messages:

    • Authentication errors typically indicate missing or incorrect API credentials; verify and update your API key.
    • Validation errors from the API may mention unsupported filter values or syntax errors in JSON queries; check the input carefully.
    • Network or timeout errors suggest connectivity issues; ensure the n8n instance has internet access and the API endpoint is reachable.

Links and References

Discussion