{ "openapi": "3.0.1", "info": { "title": "Gelbe Seiten Scraper", "description": "[💰 $1.2 / 1K] Extract German business listings from Gelbe Seiten — name, address, phone, email, website, opening hours, categories, ratings, reviews, photos, and social links. Search by what + where, or paste Gelbe Seiten URLs directly.", "version": "1.0", "x-build-id": "2OIFr8kn5IEDPJuUy" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~gelbeseiten-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-gelbeseiten-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/solidcode~gelbeseiten-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-gelbeseiten-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/solidcode~gelbeseiten-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-gelbeseiten-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": { "searchQueries": { "title": "Search Queries", "type": "array", "description": "What to search for on Gelbe Seiten (e.g. 'Restaurant', 'Klempner', 'Steuerberater', 'Friseur'). One row per search term. Leave empty if you're using direct URLs below.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "Where to search in Germany. City name (e.g. 'Berlin', 'München', 'Hamburg') or postal code (e.g. '10115'). Leave empty if your search queries already include a location, or if you're using direct URLs." }, "searchUrls": { "title": "Gelbe Seiten URLs", "type": "array", "description": "Paste Gelbe Seiten URLs directly: search results (e.g. https://www.gelbeseiten.de/suche/restaurant/berlin), category pages (e.g. https://www.gelbeseiten.de/branchen/restaurant), or individual business pages. Filters in the URL (sort, radius, postcode) are honored as-is.", "items": { "type": "string" } }, "sort": { "title": "Sort By", "enum": [ "relevanz", "bewertung" ], "type": "string", "description": "Order of results. Relevance is the Gelbe Seiten default; rating sorts the highest-rated businesses first.", "default": "relevanz" }, "includeReviews": { "title": "Include Detailed Profile Data", "type": "boolean", "description": "Visit each business's detail page to collect reviews, photos, social links, full opening hours, and services. Disable for faster, cheaper runs that return only the search-card data (name, address, phone, rating, primary category).", "default": true }, "maxReviewsPerBusiness": { "title": "Max Reviews per Business", "minimum": 0, "type": "integer", "description": "Cap on the number of reviews captured per business (most recent first). Set to 0 to capture every available review (capped internally at 5,000 per business to prevent runaway pagination). Ignored when 'Include Detailed Profile Data' is off.", "default": 20 }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Hard cap on total business rows across all queries and URLs. Default 100 — increase for bigger runs, or set to 0 for no cap (an internal upper limit of 10,000 still applies to prevent runaway pagination). The actor stops requesting new pages once this number is reached but keeps the full final page even if it slightly overshoots.", "default": 100 } } }, "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 } } }, "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 } } } } } } } } } }