handelsregister.ai

Interact with handelsregister.ai API to query German business registry data

Actions3

Overview

This node interacts with the handelsregister.ai API to search German companies using filters and pagination. It allows users to input a search query (minimum 2 characters) and optional parameters such as the number of results to skip, the limit of results per page, and a postal code filter. The node is useful for retrieving lists of German organizations matching specific criteria, which can be used for business research, lead generation, or data enrichment.

Use Case Examples

  1. Searching for companies named 'Konux' with a limit of 10 results per page.
  2. Filtering search results by postal code to find organizations in a specific area.
  3. Skipping a number of results to paginate through search results.

Properties

Name Meaning
Query The search query string used to find organizations. It must be at least 2 characters long.
Additional Fields Optional parameters to refine the search results, including the number of results to skip, the limit of results per page, and a postal code filter.

Output

JSON

- Each organization object returned by the search, containing details about the company.

  • _meta
    • total - Total number of matching organizations found.
    • request_credit_cost - The credit cost of the request.
    • credits_remaining - Remaining credits available in the account.

Dependencies

  • Requires an API key credential for handelsregister.ai API access.

Troubleshooting

  • Common issues include invalid or missing API key, which will cause authentication errors.
  • Providing a search query shorter than 2 characters will likely result in an error or no results.
  • Exceeding the limit of 100 results per page will be rejected by the API.
  • Network or API downtime can cause request failures; retrying or checking API status is recommended.

Links

Discussion