{ "openapi": "3.0.1", "info": { "title": "French Lawyers · CNB Directory Emails", "description": "Export French lawyers from the official CNB national register. Filter by barreau, city, specialty. Get email, phone, firm, SIREN — ~99% emails. Open data, no login. Lawyers or unique cabinets.", "version": "0.2", "x-build-id": "xoOpJbeUL2WCqP4uN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/corent1robert~ordre-avocats-france-annuaire/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-corent1robert-ordre-avocats-france-annuaire", "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/corent1robert~ordre-avocats-france-annuaire/runs": { "post": { "operationId": "runs-sync-corent1robert-ordre-avocats-france-annuaire", "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/corent1robert~ordre-avocats-france-annuaire/run-sync": { "post": { "operationId": "run-sync-corent1robert-ordre-avocats-france-annuaire", "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": { "mode": { "title": "Export mode", "enum": [ "lawyers", "cabinets" ], "type": "string", "description": "**Lawyers (default):** one row per avocat. **Unique cabinets:** one row per firm (SIREN) with lawyer count — better for firm-level CRM.", "default": "lawyers" }, "barreaux": { "title": "Barreau(x)", "type": "array", "description": "Select one or more CNB bar associations (exact names from the official register). Leave empty for all France (use Max items carefully).", "items": { "type": "string", "enum": [ "AGEN", "AIN", "AIX EN PROVENCE", "AJACCIO", "ALBERTVILLE", "ALBI", "ALENCON", "ALES", "ALPES de HAUTE-PROVENCE", "AMIENS", "ANGERS", "ANNECY", "ARDECHE", "ARDENNES", "ARGENTAN", "ARIEGE", "ARRAS", "AUBE", "AURILLAC", "AUXERRE", "AVESNES-SUR-HELPE", "AVEYRON", "AVIGNON", "BASTIA", "BAYONNE", "BEAUVAIS", "BELFORT", "BERGERAC-SARLAT", "BESANCON", "BETHUNE", "BEZIERS", "BLOIS", "BONNEVILLE et les PAYS du MONTBLANC", "BORDEAUX", "BOULOGNE-SUR-MER", "BOURGES", "BOURGOIN-JALLIEU", "BREST", "BRIEY", "BRIVE", "CAEN", "CAMBRAI", "CARCASSONNE", "CARPENTRAS", "CASTRES", "CHALON-SUR-SAONE", "CHALONS en CHAMPAGNE", "CHAMBERY", "CHARENTE", "CHARTRES", "CHATEAUROUX", "CHERBOURG", "CLERMONT-FERRAND", "COLMAR", "COMPIEGNE", "COUTANCES-AVRANCHES", "CREUSE", "CUSSET-VICHY", "DAX", "DEUX SEVRES", "DIEPPE", "DIJON", "DOUAI", "DRAGUIGNAN", "DUNKERQUE", "EPINAL", "ESSONNE", "EURE", "FONTAINEBLEAU", "FORT DE France (MARTINIQUE)", "GERS", "GRASSE", "GRENOBLE", "GUADELOUPE, SAINT MARTIN, SAINT BARTHELEMY", "GUYANE", "HAUTE-LOIRE", "HAUTE-MARNE", "HAUTE-SAONE", "HAUTES-ALPES", "HAUTS-DE-SEINE", "JURA", "LA ROCHE-SUR-YON", "LA ROCHELLE-ROCHEFORT", "LAON", "LAVAL", "LE HAVRE", "LE MANS", "LES SABLES D'OLONNE", "LIBOURNE", "LILLE", "LIMOGES", "LISIEUX", "LORIENT", "LOT", "LOZERE", "LYON", "MACON", "MARSEILLE", "MAYOTTE", "MEAUX", "MELUN", "METZ", "MEUSE", "MONT DE MARSAN", "MONTARGIS", "MONTBELIARD", "MONTLUCON", "MONTPELLIER", "MOULINS", "MULHOUSE", "NANCY", "NANTES", "NARBONNE", "NEVERS", "NICE", "NIMES", "NOUMEA (NOUVELLE CALEDONIE)", "ORLEANS", "PAPEETE - TAHITI (NOUVELLE CALEDONIE)", "PARIS", "PAU", "PERIGUEUX", "POITIERS", "PYRENEES ORIENTALES", "QUIMPER", "REIMS", "RENNES", "ROANNE", "ROUEN", "SAINT MALO-DINAN", "SAINT-BRIEUC", "SAINT-DENIS de LA REUNION", "SAINT-ETIENNE", "SAINT-GAUDENS", "SAINT-NAZAIRE", "SAINT-OMER", "SAINT-PIERRE de LA REUNION", "SAINT-QUENTIN", "SAINTES", "SARREGUEMINES", "SAUMUR", "SAVERNE", "SEINE-SAINT-DENIS", "SENLIS", "SENS", "SOISSONS", "STRASBOURG", "TARASCON", "TARBES", "TARN ET GARONNE", "THIONVILLE", "THONON-LES-BAINS, LEMAN et GENEVOIS", "TOULON", "TOULOUSE", "TOURS", "TULLE", "VAL D'OISE", "VAL DE MARNE", "VALENCE", "VALENCIENNES", "VANNES", "VERSAILLES", "VIENNE", "VILLEFRANCHE SUR SAONE" ], "enumTitles": [ "AGEN", "AIN", "AIX EN PROVENCE", "AJACCIO", "ALBERTVILLE", "ALBI", "ALENCON", "ALES", "ALPES de HAUTE-PROVENCE", "AMIENS", "ANGERS", "ANNECY", "ARDECHE", "ARDENNES", "ARGENTAN", "ARIEGE", "ARRAS", "AUBE", "AURILLAC", "AUXERRE", "AVESNES-SUR-HELPE", "AVEYRON", "AVIGNON", "BASTIA", "BAYONNE", "BEAUVAIS", "BELFORT", "BERGERAC-SARLAT", "BESANCON", "BETHUNE", "BEZIERS", "BLOIS", "BONNEVILLE et les PAYS du MONTBLANC", "BORDEAUX", "BOULOGNE-SUR-MER", "BOURGES", "BOURGOIN-JALLIEU", "BREST", "BRIEY", "BRIVE", "CAEN", "CAMBRAI", "CARCASSONNE", "CARPENTRAS", "CASTRES", "CHALON-SUR-SAONE", "CHALONS en CHAMPAGNE", "CHAMBERY", "CHARENTE", "CHARTRES", "CHATEAUROUX", "CHERBOURG", "CLERMONT-FERRAND", "COLMAR", "COMPIEGNE", "COUTANCES-AVRANCHES", "CREUSE", "CUSSET-VICHY", "DAX", "DEUX SEVRES", "DIEPPE", "DIJON", "DOUAI", "DRAGUIGNAN", "DUNKERQUE", "EPINAL", "ESSONNE", "EURE", "FONTAINEBLEAU", "FORT DE France (MARTINIQUE)", "GERS", "GRASSE", "GRENOBLE", "GUADELOUPE, SAINT MARTIN, SAINT BARTHELEMY", "GUYANE", "HAUTE-LOIRE", "HAUTE-MARNE", "HAUTE-SAONE", "HAUTES-ALPES", "HAUTS-DE-SEINE", "JURA", "LA ROCHE-SUR-YON", "LA ROCHELLE-ROCHEFORT", "LAON", "LAVAL", "LE HAVRE", "LE MANS", "LES SABLES D'OLONNE", "LIBOURNE", "LILLE", "LIMOGES", "LISIEUX", "LORIENT", "LOT", "LOZERE", "LYON", "MACON", "MARSEILLE", "MAYOTTE", "MEAUX", "MELUN", "METZ", "MEUSE", "MONT DE MARSAN", "MONTARGIS", "MONTBELIARD", "MONTLUCON", "MONTPELLIER", "MOULINS", "MULHOUSE", "NANCY", "NANTES", "NARBONNE", "NEVERS", "NICE", "NIMES", "NOUMEA (NOUVELLE CALEDONIE)", "ORLEANS", "PAPEETE - TAHITI (NOUVELLE CALEDONIE)", "PARIS", "PAU", "PERIGUEUX", "POITIERS", "PYRENEES ORIENTALES", "QUIMPER", "REIMS", "RENNES", "ROANNE", "ROUEN", "SAINT MALO-DINAN", "SAINT-BRIEUC", "SAINT-DENIS de LA REUNION", "SAINT-ETIENNE", "SAINT-GAUDENS", "SAINT-NAZAIRE", "SAINT-OMER", "SAINT-PIERRE de LA REUNION", "SAINT-QUENTIN", "SAINTES", "SARREGUEMINES", "SAUMUR", "SAVERNE", "SEINE-SAINT-DENIS", "SENLIS", "SENS", "SOISSONS", "STRASBOURG", "TARASCON", "TARBES", "TARN ET GARONNE", "THIONVILLE", "THONON-LES-BAINS, LEMAN et GENEVOIS", "TOULON", "TOULOUSE", "TOURS", "TULLE", "VAL D'OISE", "VAL DE MARNE", "VALENCE", "VALENCIENNES", "VANNES", "VERSAILLES", "VIENNE", "VILLEFRANCHE SUR SAONE" ] } }, "departments": { "title": "Department codes", "type": "array", "description": "Optional postal department codes from the register (mainland + overseas).", "items": { "type": "string", "enum": [ "01", "02", "03", "04", "05", "06", "07", "08", "09", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31", "32", "33", "34", "35", "36", "37", "38", "39", "40", "41", "42", "43", "44", "45", "46", "47", "48", "49", "50", "51", "52", "53", "54", "55", "56", "57", "58", "59", "60", "61", "62", "63", "64", "65", "66", "67", "68", "69", "70", "71", "72", "73", "74", "75", "76", "77", "78", "79", "80", "81", "82", "83", "84", "85", "86", "87", "88", "89", "90", "91", "92", "93", "94", "95", "99", "970", "971", "972", "973", "974", "976", "987", "988" ], "enumTitles": [ "01 — Ain", "02 — Aisne", "03 — Allier", "04 — Alpes-de-Haute-Provence", "05 — Hautes-Alpes", "06 — Alpes-Maritimes", "07 — Ardèche", "08 — Ardennes", "09 — Ariège", "10 — Aube", "11 — Aude", "12 — Aveyron", "13 — Bouches-du-Rhône", "14 — Calvados", "15 — Cantal", "16 — Charente", "17 — Charente-Maritime", "18 — Cher", "19 — Corrèze", "20 — Corse", "21 — Côte-d’Or", "22 — Côtes-d’Armor", "23 — Creuse", "24 — Dordogne", "25 — Doubs", "26 — Drôme", "27 — Eure", "28 — Eure-et-Loir", "29 — Finistère", "30 — Gard", "31 — Haute-Garonne", "32 — Gers", "33 — Gironde", "34 — Hérault", "35 — Ille-et-Vilaine", "36 — Indre", "37 — Indre-et-Loire", "38 — Isère", "39 — Jura", "40 — Landes", "41 — Loir-et-Cher", "42 — Loire", "43 — Haute-Loire", "44 — Loire-Atlantique", "45 — Loiret", "46 — Lot", "47 — Lot-et-Garonne", "48 — Lozère", "49 — Maine-et-Loire", "50 — Manche", "51 — Marne", "52 — Haute-Marne", "53 — Mayenne", "54 — Meurthe-et-Moselle", "55 — Meuse", "56 — Morbihan", "57 — Moselle", "58 — Nièvre", "59 — Nord", "60 — Oise", "61 — Orne", "62 — Pas-de-Calais", "63 — Puy-de-Dôme", "64 — Pyrénées-Atlantiques", "65 — Hautes-Pyrénées", "66 — Pyrénées-Orientales", "67 — Bas-Rhin", "68 — Haut-Rhin", "69 — Rhône", "70 — Haute-Saône", "71 — Saône-et-Loire", "72 — Sarthe", "73 — Savoie", "74 — Haute-Savoie", "75 — Paris", "76 — Seine-Maritime", "77 — Seine-et-Marne", "78 — Yvelines", "79 — Deux-Sèvres", "80 — Somme", "81 — Tarn", "82 — Tarn-et-Garonne", "83 — Var", "84 — Vaucluse", "85 — Vendée", "86 — Vienne", "87 — Haute-Vienne", "88 — Vosges", "89 — Yonne", "90 — Territoire de Belfort", "91 — Essonne", "92 — Hauts-de-Seine", "93 — Seine-Saint-Denis", "94 — Val-de-Marne", "95 — Val-d’Oise", "99 — Other / foreign", "970 — DOM (legacy)", "971 — Guadeloupe", "972 — Martinique", "973 — Guyane", "974 — La Réunion", "976 — Mayotte", "987 — Polynésie française", "988 — Nouvelle-Calédonie" ] } }, "cities": { "title": "Cities", "type": "array", "description": "Optional city name contains-match (free text). Too many cities for a dropdown — e.g. Lyon, Bordeaux.", "items": { "type": "string" } }, "specialties": { "title": "Specialty keywords", "type": "array", "description": "Match official specialty labels (contains), e.g. `Droit du travail`, `Droit fiscal`, `Droit pénal`. Only ~6% of lawyers publish a specialty — high-intent niche.", "items": { "type": "string" } }, "keywords": { "title": "Keywords", "type": "array", "description": "Match name, firm, email, city or barreau (contains).", "items": { "type": "string" } }, "requireEmail": { "title": "Require email", "enum": [ "no", "yes" ], "type": "string", "description": "**No (default):** keep rows without email (~0.3%). **Yes:** email-only CRM lists.", "default": "no" }, "requirePhone": { "title": "Require phone", "enum": [ "no", "yes" ], "type": "string", "description": "**No (default).** **Yes:** only rows with a published phone.", "default": "no" }, "requireSpecialty": { "title": "Require specialty", "enum": [ "no", "yes" ], "type": "string", "description": "**No (default).** **Yes:** only lawyers with at least one official specialty.", "default": "no" }, "excludeSalaried": { "title": "Exclude salaried lawyers", "enum": [ "no", "yes" ], "type": "string", "description": "**No (default).** **Yes:** keep independent / firm partners only (skip salariés).", "default": "no" }, "maxItems": { "title": "Max items", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Row ceiling. Default **50**. **0** = no ceiling (all matches). Free plans capped at 100 / run.", "default": 50 } } }, "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 } } } } } } } } } }