Skip to main content
Enrichments

Impressum Scraper

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.

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.

Example results (sample data and credit amounts):

json
{
  "taskId": "00000000000040008000000000000001",
  "results": [
    {
      "inputId": "row-1",
      "status": "success",
      "outputs": {
        "companyName": "Example GmbH",
        "postalAddress": "Example Street 1, 10115 Berlin, Germany",
        "impressumUrl": "https://example.com/impressum"
      },
      "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 50 results; limit accepts 1–100. A page is at most 128 KiB, so it may contain fewer results than requested.