Create Impressum Scraper task

post/v1/enrichments/tasks

Authorizations

Authorizationstringheaderrequired

Use an account access token as Bearer <token>.

Get an access token ↗

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.

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.

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

The API returns 202 Accepted with a task ID. Save it and check links.self every few seconds. Once the task is completed, failed, or stopped, get Impressum Scraper task results. The response below is sample data.

Impressum Scraper overview · Shared task reference

Request

PythoncURLJavaScriptPHPGo

import requests

url = "https://api.datablist.com/v1/enrichments/tasks"

headers = {
    "Accept": "application/json",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

payload = {
    "enrichmentId": "impressum-scraper",
    "uniqueId": "impressum-scraper-example",
    "settings": {},
    "inputs": [{
        "inputId": "row-1",
        "data": {
            "websiteUrl": "https://example.com"
        }
    }]
}

response = requests.post(url, headers=headers, json=payload)

print(response.text)

Response · illustrative example

202

{
  "@id": "00000000000040008000000000000001",
  "@type": "EnrichmentTask",
  "kind": "enrichment",
  "enrichmentId": "impressum-scraper",
  "uniqueId": "impressum-scraper-example",
  "status": "queued",
  "createdAt": "2026-10-09T10:00:00Z",
  "startedAt": null,
  "finishedAt": null,
  "progress": {
    "totalInputs": 1,
    "finishedInputs": 0
  },
  "credits": {
    "used": "0",
    "max": null
  },
  "error": null,
  "links": {
    "self": "https://api.datablist.com/v1/enrichments/tasks/00000000000040008000000000000001",
    "results": "https://api.datablist.com/v1/enrichments/tasks/00000000000040008000000000000001/results",
    "inputs": "https://api.datablist.com/v1/enrichments/tasks/00000000000040008000000000000001/inputs"
  },
  "outcomes": {
    "success": 0,
    "noResult": 0,
    "error": 0,
    "skipped": 0
  }
}