{ "openapi": "3.0.1", "info": { "title": "Germany Lawyers Scraper - BRAK Attorney Register", "description": "Scrape the official German lawyer register (BRAV/BRAK) for admitted Rechtsanwälte with name, law firm, full address, phone, mobile, EMAIL, website, bar chamber (Kammer), admission date and Fachanwalt titles. Filter by city, chamber, name or firm. Export to JSON, CSV or Excel.", "version": "0.1", "x-build-id": "y1GFfJxm1Ihx3K15R" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~germany-lawyers-brak-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-germany-lawyers-brak-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/scrapers_lat~germany-lawyers-brak-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-germany-lawyers-brak-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/scrapers_lat~germany-lawyers-brak-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-germany-lawyers-brak-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": { "cities": { "title": "Cities (Orte)", "type": "array", "description": "One or more German cities/towns to search (for example Berlin, München, Hamburg). Each is searched separately. Combine with a chamber or name to narrow large cities.", "items": { "type": "string" } }, "chamber": { "title": "Bar chamber (Rechtsanwaltskammer)", "enum": [ "", "BA", "B", "BRB", "BS", "HB", "BGH", "CE", "D", "F", "FR", "HH", "HAM", "KA", "KS", "KO", "K", "SN", "M", "N", "OL", "SB", "DD", "MD", "SL", "S", "EF", "TÜ", "ZW" ], "type": "string", "description": "Restrict to one regional bar chamber.", "default": "" }, "lastName": { "title": "Last name (Name)", "type": "string", "description": "Optional. Filter by the lawyer's surname." }, "firstName": { "title": "First name (Vorname)", "type": "string", "description": "Optional. Filter by the lawyer's first name." }, "firmName": { "title": "Law firm (Kanzlei)", "type": "string", "description": "Optional. Filter by the name of the law firm." }, "postcode": { "title": "Postcode (PLZ)", "type": "string", "description": "Optional. Filter by a German postal code." }, "specialization": { "title": "Specialist title (Fachanwalt)", "enum": [ "", "1", "2", "3", "4", "5", "6", "7", "8", "24", "9", "10", "11", "12", "13", "14", "23", "15", "16", "17", "18", "19", "20", "21", "22", "0" ], "type": "string", "description": "Optional. Restrict to lawyers holding a given specialist-attorney (Fachanwalt) title.", "default": "" }, "publicDefenderOnly": { "title": "Only lawyers open to legal-aid defence", "type": "boolean", "description": "Only return lawyers who indicate interest in public-defender / legal-aid mandates (Pflichtverteidigung).", "default": false }, "maxLawyers": { "title": "Max Lawyers To Scrape", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of lawyers to collect across all searches." }, "withAiProfileSummary": { "title": "AI profile summary (paid add-on)", "type": "boolean", "description": "Opt-in. Adds an AI-written 1-2 sentence professional profile for each lawyer. Charged per lawyer only when a summary is produced. Requires a paid Apify plan.", "default": false }, "withAiLeadScore": { "title": "AI lead score (paid add-on)", "type": "boolean", "description": "Opt-in. Scores each lawyer 0-100 as a B2B outreach/referral lead with a hot/warm/cold tier and rationale. Charged per lawyer only when a score is produced. Requires a paid Apify plan.", "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 } } }, "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 } } } } } } } } } }