{ "openapi": "3.0.1", "info": { "title": "Das Telefonbuch Scraper - German Business Leads & New Listings", "description": "For B2B lead lists and local sales teams: German businesses from Das Telefonbuch by category or company name and city, district or postcode, with name, address, phone in +49 format, website, category and rating. Monitor returns only newly listed businesses. Businesses only, no private persons.", "version": "0.1", "x-build-id": "45fK1t4S2bzS2Iv5v" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neverempty~das-telefonbuch-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neverempty-das-telefonbuch-scraper", "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/neverempty~das-telefonbuch-scraper/runs": { "post": { "operationId": "runs-sync-neverempty-das-telefonbuch-scraper", "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/neverempty~das-telefonbuch-scraper/run-sync": { "post": { "operationId": "run-sync-neverempty-das-telefonbuch-scraper", "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": { "categories": { "title": "Categories (Branchen)", "type": "array", "description": "Business categories or keywords in German, as you would type them on dastelefonbuch.de, for example Zahnarzt, Rechtsanwalt, Friseur, Steuerberater, Restaurant. Each category is searched in each location. Leave Categories, Company names and Locations all empty to run the example search Zahnarzt in Berlin.", "items": { "type": "string" } }, "companyNames": { "title": "Company names (Firmen)", "type": "array", "description": "Optional. Company names to look up in each location, for example Siemens or Abacus. Uses the directory's company search, which lists businesses only.", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "German cities, districts or 5-digit postcodes, for example Berlin, Berlin-Charlottenburg, Frankfurt am Main, München, 10707. Categories and company names times locations make the searches of a run (up to 10 per run).", "items": { "type": "string" } }, "maxResultsPerSearch": { "title": "Max businesses per search", "minimum": 1, "maximum": 500, "type": "integer", "description": "Most businesses returned for one search (one category or company name in one location). Das Telefonbuch shows at most 500 for one search; for bigger lists use districts or postcodes. Empty = 50. In monitor mode it limits the new businesses returned per search in one run; the rest come in the next run." }, "onlyNew": { "title": "Monitor mode: only newly listed businesses", "type": "boolean", "description": "On: every run reads the whole list of each search and returns only businesses that were not on it at the previous check (the first run returns up to Max businesses per search and remembers the whole list as the starting point). Runs where nothing is new return a free row saying so. A search with more than 500 businesses cannot be watched completely and returns a free row asking for a smaller area. Off = return the list as it is now." }, "watchName": { "title": "Watch name", "type": "string", "description": "Optional. Keeps separate memories for monitor mode, for example one per client (letters, digits, dot, dash, underscore; up to 40). Runs with the same watch name and the same search share what has already been returned." }, "resetMonitoringState": { "title": "Start the watch again", "type": "boolean", "description": "On: forget what this watch has seen for these searches before running, so this run is a first check again." } } }, "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 } } } } } } } } } }