Get Impressum Scraper task results

get/v1/enrichments/tasks/{taskId}/results

Authorizations

Authorizationstringheaderrequired

Use an account access token as Bearer <token>.

Get an access token ↗

Read results from a Impressum Scraper task using the task ID returned at creation. All enrichment tools use this endpoint; the task ID selects the results.

Parameters

Parameter	Location	Required	Description
taskId	Path	Yes	Your actual task ID from the create response.
limit	Query	No	Results per page, from 1 to 100. Defaults to 50.
cursor	Query	No	The previous page's non-null nextCursor, passed unchanged. Omit it for the first page.

Pagination example: GET https://api.datablist.com/v1/enrichments/tasks/:taskId/results?limit=50&cursor=XX.

Task readiness

Read results when the task is completed, failed, or stopped. While it is active, this endpoint returns 409 ResultsNotReady. Failed and stopped tasks can still have results and credit usage. Use the status endpoint to check progress; this page does not check or retry automatically.

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.

Cost: 10 credits per website

Sample results

The response below uses sample data and credit amounts. Pages are at most 128 KiB. If nextCursor is not null, pass it unchanged as cursor in the next request.

Impressum Scraper overview · Shared results guide

Request

PythoncURLJavaScriptPHPGo

import requests

url = "https://api.datablist.com/v1/enrichments/tasks/<taskId>/results"

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

response = requests.get(url, headers=headers)

print(response.text)

Response · illustrative example

200

{
  "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
}