{
"openapi": "3.0.1",
"info": {
"title": "Gelbe Seiten Scraper: German Business Leads, Emails & Impressum",
"description": "Scrape Gelbe Seiten (gelbeseiten.de), Germany's yellow pages: business name, address, phone, email, website, rating and categories by trade and city; optionally each business page (opening hours, services, fax) and its website's Impressum (owners, HRB number, VAT ID). No login.",
"version": "1.0",
"x-build-id": "FL1aWXaYTjyaJEdPD"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/steadyscrape~gelbe-seiten-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-steadyscrape-gelbe-seiten-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/steadyscrape~gelbe-seiten-scraper/runs": {
"post": {
"operationId": "runs-sync-steadyscrape-gelbe-seiten-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/steadyscrape~gelbe-seiten-scraper/run-sync": {
"post": {
"operationId": "run-sync-steadyscrape-gelbe-seiten-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": {
"searchTerms": {
"title": "Trades",
"type": "array",
"description": "What to search, one per line, as Gelbe Seiten names the trade: Zahnarzt, Steuerberater, Elektriker, Friseur, Dachdecker, Restaurant, Rechtsanwalt. Each trade is searched in every place. A trade the site answers only on its search page (e.g. Friseure) is a free row that suggests the names it has list pages for (friseur). Up to 50.",
"items": {
"type": "string"
}
},
"locations": {
"title": "Places",
"type": "array",
"description": "Where to search, one per line: a town or city (Berlin, München, Frankfurt am Main, Ahrensburg) or a district as the site writes it (Berlin Bezirk Mitte, Köln Stadtteil Ehrenfeld). Loose spellings such as Berlin Mitte or Frankfurt are followed to the site's own name. Up to 200.",
"items": {
"type": "string"
}
},
"startUrls": {
"title": "Gelbe Seiten links",
"type": "array",
"description": "Links copied from gelbeseiten.de, one per line: a results list (https://www.gelbeseiten.de/branchen/zahnarzt/berlin) is walked like a search; a business page (https://www.gelbeseiten.de/gsbiz/…) is read on its own and charged as a business with details. Search pages (/suche/…) are closed to automated readers by the site's robots.txt and are free rows. Up to 5,000.",
"items": {
"type": "string"
}
},
"maxResultsPerSearch": {
"title": "Max businesses per search",
"minimum": 1,
"maximum": 20000,
"type": "integer",
"description": "Stop each trade in each place (and each results link) after this many businesses. Berlin lists 1,343 dentists; the site shows 50 at first and 10 more per request after that. The run's spending limit is respected too.",
"default": 100
},
"includeDetails": {
"title": "Read each business page (business-with-details)",
"type": "boolean",
"description": "Also read every business's own Gelbe Seiten page: email where the list shows none (about 8 in 10 dentists have one), every category, services, description, opening hours per day, fax, payment methods, coordinates, social profiles and the date the entry last changed. Charged as business-with-details instead of business.",
"default": false
},
"includeImprint": {
"title": "Read the Impressum of each business's website",
"type": "boolean",
"description": "Also read the Impressum (legal notice) of each business's own website: the legal name, legal form, managing directors or owners, register court and HRB number, VAT ID, tax number, emails and phone. Charged as imprint (on top of the business) only when the Impressum names the company; no website, a Facebook or directory page, or a site that does not answer is free and says why in imprint.status.",
"default": false
}
}
},
"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
}
}
}
}
}
}
}
}
}
}