{ "openapi": "3.0.1", "info": { "title": "France Lawyers Scraper: CNB Avocat Directory (Email & Phone)", "description": "Scrape the official CNB directory of ~80,000 French lawyers. Get name, bar (barreau), full address, city, postcode, phone, fax, email, law firm, SIREN, specializations and languages. Filter by name, city, postcode, barreau, spécialité or language. Export to JSON, CSV or Excel.", "version": "0.1", "x-build-id": "NNuQCXJWHyAms6IiD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~france-lawyers-cnb-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-france-lawyers-cnb-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~france-lawyers-cnb-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-france-lawyers-cnb-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~france-lawyers-cnb-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-france-lawyers-cnb-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": { "barreaux": { "title": "Bars (Barreaux)", "type": "array", "description": "Keep only lawyers registered at these bars, e.g. \"PARIS\", \"LYON\", \"MARSEILLE\", \"AIX EN PROVENCE\". Accent-insensitive, matches on contains. There are 164 bars in France.", "items": { "type": "string" } }, "cities": { "title": "Cities", "type": "array", "description": "Keep only lawyers whose office city matches one of these (accent-insensitive), e.g. \"PARIS\", \"BORDEAUX\", \"NICE\".", "items": { "type": "string" } }, "postalCodes": { "title": "Postal Codes", "type": "array", "description": "Keep only lawyers whose postcode starts with one of these, e.g. \"75\" for Paris, \"69\" for the Rhône, \"13008\" for a precise area.", "items": { "type": "string" } }, "names": { "title": "Names", "type": "array", "description": "Keep only lawyers whose first or last name contains one of these terms (accent-insensitive), e.g. \"Dupont\", \"Marie\".", "items": { "type": "string" } }, "specializations": { "title": "Specializations (Spécialités)", "type": "array", "description": "Keep only lawyers holding one of these official CNB specializations (matches on contains), e.g. \"Droit du travail\", \"Droit de la famille\", \"Droit des sociétés\", \"Droit fiscal\".", "items": { "type": "string" } }, "languages": { "title": "Languages Spoken", "type": "array", "description": "Keep only lawyers who list one of these spoken languages, e.g. \"Anglais\", \"Espagnol\", \"Allemand\", \"Italien\".", "items": { "type": "string" } }, "specialistsOnly": { "title": "Specialists Only", "type": "boolean", "description": "If enabled, keep only lawyers who hold at least one official specialization certificate.", "default": false }, "maxLawyers": { "title": "Max Lawyers To Scrape", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Maximum number of lawyer records to return." }, "withAiProfileSummary": { "title": "AI profile summary (paid add-on)", "type": "boolean", "description": "Add an AI-generated outreach-ready profile of each lawyer (practice, specializations, firm, languages). Charged only on usable output. Requires a paid Apify plan.", "default": false }, "withAiLeadScore": { "title": "AI lead score (paid add-on)", "type": "boolean", "description": "Add an AI lead qualification score (0-100), tier and rationale for B2B outreach. Charged only on usable output. 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 } } } } } } } } } }