Handelsregister API Bulk

Pricing

from $50.00 / 1,000 results

Handelsregister API Bulk

Enter multiple company names and automatically receive addresses, managing directors, HRB data, EU ID, legal form, and structured information for download. Perfect for CRM sync, compliance checks and lead research. All data included.

Pricing

from $50.00 / 1,000 results

Rating

0.0

(0)

Developer

Luca S.

Maintained by Community

Actor stats

Bookmarked

Total users

Monthly active users

12 days ago

Last modified

Categories

Lead generation

Integrations

Automation

You can access the Handelsregister API Bulk programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "1.0",
    "x-build-id": "ikiZj8hzYHKBFQXrU"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/luca-artur~handelsregister-api-bulk/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-luca-artur-handelsregister-api-bulk",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/luca-artur~handelsregister-api-bulk/runs": {
      "post": {
        "operationId": "runs-sync-luca-artur-handelsregister-api-bulk",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/luca-artur~handelsregister-api-bulk/run-sync": {
      "post": {
        "operationId": "run-sync-luca-artur-handelsregister-api-bulk",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "required": [
          "keywords"
        ],
        "properties": {
          "keywords": {
            "title": "Company names / Keywords",
            "minItems": 1,
            "uniqueItems": true,
            "type": "array",
            "description": "Search for company names or keywords. Add one or more lines",
            "items": {
              "type": "string"
            }
          },
          "keywordOptions": {
            "title": "Keyword options",
            "enum": [
              "all",
              "min",
              "exact"
            ],
            "type": "string",
            "description": "All words: Registry data containing all of the specified keywords will be found.\nAt least one: All registry data containing at least one of the specified terms will be found.\nExact company name: Only companies that exactly match the company name entered will be found.",
            "default": "exact"
          },
          "includeSimilarSpellings": {
            "title": "Similarly spelled keywords",
            "type": "boolean",
            "description": "Expands the search to similarly written terms according to Kölner Phonetik.",
            "default": false
          },
          "states": {
            "title": "Federal states",
            "type": "array",
            "description": "Limit your search to federal states",
            "items": {
              "type": "string",
              "enum": [
                "BW",
                "BY",
                "BE",
                "BB",
                "HB",
                "HH",
                "HE",
                "MV",
                "NI",
                "NW",
                "RP",
                "SL",
                "SN",
                "ST",
                "SH",
                "TH"
              ],
              "enumTitles": [
                "Baden-Württemberg",
                "Bayern",
                "Berlin",
                "Brandenburg",
                "Bremen",
                "Hamburg",
                "Hessen",
                "Mecklenburg-Vorpommern",
                "Niedersachsen",
                "Nordrhein-Westfalen",
                "Rheinland-Pfalz",
                "Saarland",
                "Sachsen",
                "Sachsen-Anhalt",
                "Schleswig-Holstein",
                "Thüringen"
              ]
            }
          },
          "registerType": {
            "title": "Register type",
            "enum": [
              "alle",
              "HRA",
              "HRB",
              "PR",
              "GnR",
              "VR"
            ],
            "type": "string",
            "description": "Limit your search to register types",
            "default": "alle"
          },
          "rateTime": {
            "title": "Rate Time",
            "minimum": 0,
            "type": "integer",
            "description": "Select a rate time that complies with the legal requirement of Handelsregister (60 queries per hour).",
            "default": 0
          },
          "saveStructuredData": {
            "title": "Save company details, managing directors and structured data",
            "type": "boolean",
            "description": "Save company address, object, managing directors and share capital. Save the Strukturierter Registerinhalt XML file in storage.",
            "default": true
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Handelsregister API Bulk OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for Handelsregister API Bulk from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

Handelsregister API Bulk API in Python

Handelsregister API Bulk API in JavaScript

Handelsregister API Bulk API through CLI

Handelsregister API Bulk API

EU VAT ID Validator

juliandev/vat-id-validator

Validate EU VAT IDs instantly using the official VIES API. Returns company name & address for all 27 EU countries. Perfect for e-commerce checkout, invoicing & compliance checks.

Julian

Handelsregister API

radeance/handelsregister-api

Access valuable key company data from the German Commercial Register in realtime from Handelsregister.de: shareholders, executives, addresses, court details, and official documents. Ideal for LegalTech, compliance, and due diligence workflows.

Radeance

5.0

German Imprint Scraper

codescraper/german-imprint-scraper

A powerful Actor scraper to find and extract legal "Impressum" data from German websites. Get company names, addresses, decision-makers, legal IDs, and more, all automatically.

CodeScraper

5.0

Inventory Sync API

vivid_astronaut/inventory-sync

Fabio Suizu

Notion AI Database Extractor & Sync Tool

tuguidragos/notion-ai-database-sync

Extract, summarize, and sync your Notion databases automatically. Supports AI summaries (GPT-4o), incremental updates, and secure HMAC webhooks. Ideal for analytics, CRM sync, or automation workflows.

Țugui Dragoș

5.0

Superclean Company Names

superlativetech/superclean-company-names

Transform messy company names into clean formats for outreach. Removes legal suffixes (Inc, LLC, Ltd), fixes ALL CAPS, preserves brand identity. Perfect for cold email personalization, CRM cleanup, and lead enrichment. Supports casual, formal, and legal output styles. LLM-powered normalizer.

Superlative

Email Search

rapidtech1898/email-search

Extract all email addresses from multiple websites with ease. Simply provide the URLs and the scraper automatically finds and collects all available emails. Perfect for lead generation, outreach, and research, saving you time and manual effort.

Max Pohler

3.0

LinkedIn Company Scraper

scrapier/linkedin-company-scraper-actor

Scrape LinkedIn company data with the LinkedIn Company Scraper. Extract company names, industries, employee counts, locations, and descriptions. Ideal for market research, lead generation, and competitor analysis. Fast, accurate, and scalable for single or bulk company profiles.

Scrapier

Company Domain

meetwithyash/company-domain

Find any company's official website and social media profiles instantly. AI-powered search and verification for accurate results. Perfect for lead generation, market research, and CRM data enrichment.

Yash Khokhaneshiya

Companies House Business Data Scraper

exciting_perfume/Companies-House-Business-Data-Scraper

Unlock large-scale Companies House data without writing API code. Search companies, directors and PSCs using filters for dates, SIC codes and locations, and export tens of thousands of records in one run. Perfect for lead gen, research, compliance and enrichment workflows.