{ "openapi": "3.0.1", "info": { "title": "DACH & Benelux Business Leads — Impressum, VAT & Register", "description": "Find businesses in Germany, Austria, Switzerland, the Netherlands, Belgium and Luxembourg by category and city, then enrich each one from its website: legal name, VAT ID, commercial register (HRB, FN, CHE, KvK, KBO, RCS), emails, phones, socials. Open data, pay only for leads with contact data.", "version": "0.1", "x-build-id": "PmCRdL5JnpeFBY8nW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/eurodata-tools~dach-business-leads/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-eurodata-tools-dach-business-leads", "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/eurodata-tools~dach-business-leads/runs": { "post": { "operationId": "runs-sync-eurodata-tools-dach-business-leads", "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/eurodata-tools~dach-business-leads/run-sync": { "post": { "operationId": "run-sync-eurodata-tools-dach-business-leads", "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": { "country": { "title": "Country", "enum": [ "DE", "AT", "CH", "NL", "BE", "LU" ], "type": "string", "description": "Country to search in.", "default": "DE" }, "locations": { "title": "Cities, regions or postcodes", "type": "array", "description": "Where to search inside the country, one per line: a city or district (`München`, `Wien`, `Zürich`, `Amsterdam`), a region code (`DE-BY`, `AT-9`, `CH-ZH`) or a postcode (`80331`). Use the local name of the place. Leave empty to search the whole country.", "default": [], "items": { "type": "string" } }, "categories": { "title": "Business categories", "type": "array", "description": "Ready-made categories. Each one is mapped to the right OpenStreetMap tags (e.g. Tax advisors = office=tax_advisor).", "items": { "type": "string", "enum": [ "dentist", "doctor", "physiotherapist", "pharmacy", "veterinary", "optician", "hearing_aids", "lawyer", "notary", "tax_advisor", "accountant", "architect", "engineer", "real_estate_agent", "property_management", "insurance", "financial_advisor", "it_company", "consulting", "advertising_agency", "employment_agency", "company_office", "logistics", "manufacturer", "car_dealer", "car_repair", "tyres", "motorcycle", "bicycle", "car_rental", "driving_school", "hotel", "guest_house", "restaurant", "cafe", "bar", "bakery", "butcher", "winery", "brewery", "caterer", "hairdresser", "beauty", "florist", "furniture", "electronics", "clothes", "jewelry", "hardware", "garden_centre", "pet_shop", "travel_agency", "funeral_directors", "fitness", "language_school", "electrician", "plumber", "carpenter", "roofer", "painter", "metal_construction", "builder", "gardener", "photographer", "printer" ], "enumTitles": [ "Dentists", "Doctors / medical practices", "Physiotherapists", "Pharmacies", "Veterinarians", "Opticians", "Hearing aid shops", "Lawyers / law firms", "Notaries", "Tax advisors (Steuerberater)", "Accountants", "Architects", "Engineering offices", "Real estate agents", "Property management", "Insurance agencies", "Financial advisors", "IT / software companies", "Consulting firms", "Advertising / marketing agencies", "Recruitment / employment agencies", "Company offices (office=company)", "Logistics / moving companies", "Factories / manufacturers", "Car dealers", "Car repair / garages", "Tyre shops", "Motorcycle dealers", "Bicycle shops", "Car rental", "Driving schools", "Hotels", "Guest houses / B&Bs", "Restaurants", "Cafés", "Bars & pubs", "Bakeries", "Butchers", "Wineries & wine shops", "Breweries", "Caterers", "Hairdressers", "Beauty salons & cosmetics", "Florists", "Furniture & kitchen stores", "Electronics & computer shops", "Clothing & shoe stores", "Jewellers & watch shops", "Hardware & DIY stores", "Garden centres", "Pet shops", "Travel agencies", "Funeral directors", "Gyms & fitness studios", "Language schools", "Electricians", "Plumbers & heating (HVAC)", "Carpenters & joiners", "Roofers", "Painters & decorators", "Metal construction / locksmiths", "Builders & construction companies", "Gardeners & landscapers", "Photographers", "Print shops" ] }, "default": [] }, "osmTags": { "title": "Or: OpenStreetMap tags", "type": "array", "description": "Advanced: any OpenStreetMap tag as `key=value`, e.g. `shop=bicycle`, `craft=electrician`, `office=*` (any value). Combined with the categories above. Full list: https://wiki.openstreetmap.org/wiki/Map_features", "default": [], "items": { "type": "string" } }, "nameContains": { "title": "Name contains", "type": "string", "description": "Optional: keep only businesses whose name contains this text (case-insensitive), e.g. `Bio` or `Solar`." }, "maxResults": { "title": "Max businesses", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Maximum number of businesses in total (all locations together). When more are found, the ones with a website and a phone number come first.", "default": 100 }, "requireWebsite": { "title": "Only businesses with a website", "type": "boolean", "description": "Skip businesses that have no website in OpenStreetMap.", "default": false }, "includeLeadsWithoutContact": { "title": "Include businesses without contact data", "type": "boolean", "description": "Also return businesses where no email, phone, VAT ID or register number was found (name and address only). These rows are free.", "default": true }, "visitWebsites": { "title": "Visit websites (Impressum enrichment)", "type": "boolean", "description": "Visit each business website (start page, Impressum / legal notice, contact page) to add legal name, VAT ID, register number, emails, phones and social profiles. Turn off to get only the OpenStreetMap listing.", "default": true }, "maxPagesPerWebsite": { "title": "Max pages per website", "minimum": 1, "maximum": 10, "type": "integer", "description": "The start page plus the most useful sub-pages (Impressum, contact, about us). 3–4 is enough for almost every small business website.", "default": 4 }, "emailMode": { "title": "Which emails to return", "enum": [ "generic", "all" ], "type": "string", "description": "`generic` returns only company mailboxes such as info@, kontakt@, praxis@, office@ (GDPR-friendly). `all` also returns emails that look like a named person (max.mustermann@...). Only choose `all` if you have a lawful basis to process them.", "default": "generic" }, "includeManagingDirectors": { "title": "Include managing directors / owners", "type": "boolean", "description": "Adds the names written next to \"Geschäftsführer\", \"Inhaber\", \"Vorstand\", \"Directie\" or \"Gérant\" on the legal notice page. These are personal data: only turn this on if you have a lawful basis (GDPR) to process them.", "default": false }, "respectRobotsTxt": { "title": "Respect robots.txt", "type": "boolean", "description": "Skip website pages that the website's robots.txt does not allow to crawl. Recommended.", "default": true }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many website pages are downloaded in parallel (across different websites).", "default": 20 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Usually not needed: small business websites rarely block. Turn on Apify Proxy if many websites come back as `blocked`.", "default": { "useApifyProxy": false } }, "overpassEndpoint": { "title": "Overpass API endpoint", "type": "string", "description": "Optional: your own Overpass API URL (e.g. `https://overpass.example.com/api/interpreter`). By default the public OpenStreetMap servers are used, with automatic fallback." } } }, "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 } } } } } } } } } }