Skip to main content
Enrichments

Impressum Scraper API

post/v1/enrichments/tasks

Authorizations

X-API-Key or Authorizationstringheaderrequired

We recommend sending your Personal API Key in x-api-key. Datablist handles token renewal for you. Optionally, use an access token as Authorization: Bearer <token> if your application manages tokens itself. Send only one credential header.

Authentication options ↗

Provide a website URL to extract business details from its Impressum or legal notice page. Available fields can include company name, address, contact details, legal representatives, VAT number, and registration number.

Public ID: impressum-scraper. Get the current definition. You can read it without authentication. Check availability in the catalog.

Code examples: See our Impressum Scraper API GitHub repository for cURL and Python examples, using Requests or async HTTPX.

Settings​

No public settings are currently required. Submit an empty settings object.

Additional properties are supported.

Inputs​

Give each input an inputId you can use to match the result to your record. Put websiteUrl in its data object.

websiteUrlstringrequired

URL of the website to visit

Additional properties are supported.

Outputs​

Each result contains your inputId, a status, the data in outputs, and creditsUsed. If the input failed, error explains why; otherwise it is null.

The fields below depend on your settings and the data found. Results can include fields not yet listed in the catalog.

firstNamestring

The first name of the Managing Director/Founder. Empty if not found.

lastNamestring

The last name of the Managing Director/Founder. Empty if not found.

genderstring

The gender (male, female) of the Managing Director/Founder. Empty if not found.

companyNamestring

The name of the company, when available.

postalAddressstring

The postal address for the company, when available.

emailAddressstring

Email addresses found on the impressum page.

phoneNumberstring

The company phone number.

vatNumberstring

The company VAT number.

registrationNumberstring

The company identification number.

impressumUrlstring

The link to the impressum page.

format: "uri"
agentConfidenceScorenumber

Confidence score for the results. Between 0 and 100. The higher, the better.

Additional properties are supported.

Credits and limits​

Cost: 10 credits per website

Processing costs 10 credits per website. Missing fields do not imply a free lookup. Actual usage is reported on the task and results.

Send 1–10,000 inputs per task, within 16 KiB per input and 10 MiB per request. Tasks can run for up to 24 hours; completed, failed, or stopped tasks are kept for 90 days.

You can set maxCredits to stop starting new work after a credit threshold. Work already underway can still exceed it. Enrichment and source tasks share your account balance and task limits. See limits and errors.

Accepted task and results​

The API returns 202 Accepted with a task ID. Save it, then check links.self every few seconds. Once status is completed, failed, or stopped, read links.results. Failed and stopped tasks can still have useful results. See the task reference.

Results from Trigema, Hetzner, sipgate, manomama, and VAUDE. Names are kept as returned; email addresses are partially masked with **. The API returns full email addresses. Missing fields remain empty or null.

json
{
"taskId": "144ab27534854e1a8089ec0450b53bd5",
"results": [
{
"inputId": "row-1",
"status": "success",
"outputs": {
"emailAddress": "b**@trigema.de",
"postalAddress": "Josef-Mayer-Str. 31-35, D-72393 Burladingen",
"agentConfidenceScore": 85,
"phoneNumber": "+49 (0) 7475/88 - 0",
"registrationNumber": "HRA 740365",
"firstName": "Wolfgang",
"companyName": "Trigema W. Grupp KG",
"impressumUrl": "https://www.trigema.de/kundenservice/rechtliches/impressum/",
"vatNumber": "DE144846566",
"lastName": "Grupp",
"gender": "male"
},
"creditsUsed": "10",
"error": null
},
{
"inputId": "row-2",
"status": "success",
"outputs": {
"emailAddress": "i**@hetzner.com",
"postalAddress": "Industriestr. 25, 91710 Gunzenhausen, Germany",
"agentConfidenceScore": 85,
"phoneNumber": "+49 (0)9831 505-0",
"registrationNumber": "HRB 6089",
"firstName": "Martin",
"companyName": "Hetzner Online GmbH",
"impressumUrl": null,
"vatNumber": "DE 812871812",
"lastName": "Hetzner",
"gender": "male"
},
"creditsUsed": "10",
"error": null
},
{
"inputId": "row-3",
"status": "success",
"outputs": {
"emailAddress": "i**@sipgate.de",
"postalAddress": "Gladbacher Straße 74, 40219 Düsseldorf",
"agentConfidenceScore": 90,
"phoneNumber": "+49 211 635555-0",
"registrationNumber": "HRB 39841",
"firstName": "Thilo",
"companyName": "sipgate GmbH",
"impressumUrl": null,
"vatNumber": "DE219349391",
"lastName": "Salmon",
"gender": "male"
},
"creditsUsed": "10",
"error": null
},
{
"inputId": "row-4",
"status": "success",
"outputs": {
"emailAddress": "s**@manomama.de",
"postalAddress": "Willy-Brandt-Platz 1a, 86153 Augsburg",
"agentConfidenceScore": 90,
"phoneNumber": "+49 (0)821 567 428 - 0",
"registrationNumber": "HRB 25182",
"firstName": "Sina",
"companyName": "MANOMAMA GmbH",
"impressumUrl": "https://www.manomama.de/pages/impressum",
"vatNumber": "",
"lastName": "Trinkwalder",
"gender": "female"
},
"creditsUsed": "10",
"error": null
},
{
"inputId": "row-5",
"status": "success",
"outputs": {
"emailAddress": "s**@service.vaude.com",
"postalAddress": "Vaude Straße 2, 88069 Tettnang",
"agentConfidenceScore": 90,
"phoneNumber": "0049 (0)7542-5306-0",
"registrationNumber": "HRB 631715",
"firstName": "Antje",
"companyName": "VAUDE Sport GmbH & Co. KG",
"impressumUrl": "https://www.vaude.com/de/de/impressum.html",
"vatNumber": "DE203894755",
"lastName": "von Dewitz",
"gender": "female"
},
"creditsUsed": "10",
"error": null
}
],
"nextCursor": null
}

If nextCursor is not null, pass it unchanged in the next request to get more results. Pages default to 500 results; limit accepts 1–1,000. A page is at most 128 KiB, so it may contain fewer results than requested.

Last updated on