Impressum Scraper API
Authorizations
X-API-Key or AuthorizationstringheaderrequiredWe 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.
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.
websiteUrlstringrequiredURL 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.
firstNamestringThe first name of the Managing Director/Founder. Empty if not found.
lastNamestringThe last name of the Managing Director/Founder. Empty if not found.
genderstringThe gender (male, female) of the Managing Director/Founder. Empty if not found.
companyNamestringThe name of the company, when available.
postalAddressstringThe postal address for the company, when available.
emailAddressstringEmail addresses found on the impressum page.
phoneNumberstringThe company phone number.
vatNumberstringThe company VAT number.
registrationNumberstringThe company identification number.
impressumUrlstringThe link to the impressum page.
"uri"agentConfidenceScorenumberConfidence 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.
{ "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.