{ "openapi": "3.0.1", "info": { "title": "Impressum Scraper — DACH Register No., VAT ID & Legal Name", "description": "Turn German, Austrian and Swiss domains into verified company data from each site's Impressum: legal name and form, address, register court and number (HRB, FN, UID), checksum-checked VAT ID, phone and role mailboxes. One row per domain. Misses are free.", "version": "0.1", "x-build-id": "TgBcMnlkPG5MUwpqz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/yugenox~impressum-company-data-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-yugenox-impressum-company-data-extractor", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/yugenox~impressum-company-data-extractor/runs": { "post": { "operationId": "runs-sync-yugenox-impressum-company-data-extractor", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/yugenox~impressum-company-data-extractor/run-sync": { "post": { "operationId": "run-sync-yugenox-impressum-company-data-extractor", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "domains": { "title": "🌐 Domains or websites", "type": "array", "description": "Company domains, website URLs or company e-mail addresses, one per line, e.g. \"sipgate.de\", \"https://www.hetzner.com\", \"info@firma.at\". A URL that points straight at the Impressum page is read directly. Personal mail providers (gmail.com, gmx.de, web.de …) are skipped.", "items": { "type": "string" } }, "maxItems": { "title": "Max companies", "minimum": 0, "maximum": 50000, "type": "integer", "description": "Stop after this many companies were found (only found companies count and are charged). 0 = check the whole list.", "default": 0 }, "countryHint": { "title": "Country hint", "enum": [ "", "DE", "AT", "CH", "LI" ], "type": "string", "description": "Optional: the country most of your websites are in. Used only to tell Austrian and Swiss 4-digit postcodes apart when a page doesn't say which country it is in. Leave empty to detect it from each page.", "default": "" }, "includeRoleEmails": { "title": "Include role mailboxes", "type": "boolean", "description": "Add the company's own role mailboxes from the Impressum (info@, kontakt@, office@, support@ …). Personal addresses (firstname.lastname@) are never collected.", "default": true }, "includeMisses": { "title": "One row for every domain", "type": "boolean", "description": "Also save a free status row for domains where no company data was found (no Impressum, website refused, unreachable, parked …), so you can match the results back to your list. These rows carry no company data and are never charged.", "default": true }, "maxConcurrency": { "title": "Websites at a time", "minimum": 5, "maximum": 20, "type": "integer", "description": "How many different websites are checked side by side (5–20). Up to 10 per 256 MB of run memory, so 20 needs 512 MB. Each website itself gets one request at a time and its robots.txt Crawl-delay is respected.", "default": 10 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy (datacenter) is the default and comes with every Apify plan. You can also paste your own proxy URLs.", "default": { "useApifyProxy": true } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }