{ "openapi": "3.0.1", "info": { "title": "France Company Registry Scraper", "description": "Scrape the official French government company registry (SIRENE / Recherche d'entreprises). Search by name or SIREN/SIRET, look up exact SIREN numbers, or find companies near a location. Returns legal name, address, activity code, executives, and financial data.", "version": "1.0", "x-build-id": "GHJ6RU6JxP5CeyDpi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~france-entreprises-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-france-entreprises-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/crawlerbros~france-entreprises-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-france-entreprises-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/crawlerbros~france-entreprises-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-france-entreprises-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "byIds", "nearPoint" ], "type": "string", "description": "What to fetch.", "default": "search" }, "searchQuery": { "title": "Search query", "type": "string", "description": "Free-text query — company name, brand name, SIREN or SIRET number (mode=search).", "default": "danone" }, "sirens": { "title": "SIREN numbers (mode=byIds)", "type": "array", "description": "9-digit French company identifiers (SIREN), e.g. `552032534`.", "default": [], "items": { "type": "string" } }, "latitude": { "title": "Latitude (mode=nearPoint)", "minimum": -90, "maximum": 90, "type": "number", "description": "Latitude of the search center point.", "default": 48.8566 }, "longitude": { "title": "Longitude (mode=nearPoint)", "minimum": -180, "maximum": 180, "type": "number", "description": "Longitude of the search center point.", "default": 2.3522 }, "radiusKm": { "title": "Radius in km (mode=nearPoint)", "minimum": 0.1, "maximum": 50, "type": "number", "description": "Search radius around the point, up to 50 km.", "default": 2 }, "activitePrincipale": { "title": "Activity code (NAF/APE)", "type": "string", "description": "Filter by INSEE NAF/APE activity code, e.g. `62.01Z` (computer programming). Comma-separate for multiple codes." }, "sectionActivitePrincipale": { "title": "Activity sector", "type": "array", "description": "Filter by one or more top-level NAF economic activity sectors (OR match).", "items": { "type": "string", "enum": [ "A", "B", "C", "D", "E", "F", "G", "H", "I", "J", "K", "L", "M", "N", "O", "P", "Q", "R", "S", "T", "U" ], "enumTitles": [ "A - Agriculture, forestry and fishing", "B - Mining and quarrying", "C - Manufacturing", "D - Electricity, gas, steam and air conditioning supply", "E - Water supply; sewerage, waste management", "F - Construction", "G - Wholesale and retail trade; repair of vehicles", "H - Transportation and storage", "I - Accommodation and food service activities", "J - Information and communication", "K - Financial and insurance activities", "L - Real estate activities", "M - Professional, scientific and technical activities", "N - Administrative and support service activities", "O - Public administration", "P - Education", "Q - Human health and social work activities", "R - Arts, entertainment and recreation", "S - Other service activities", "T - Activities of households as employers", "U - Activities of extraterritorial organisations" ] }, "default": [] }, "categorieEntreprise": { "title": "Company size category", "type": "array", "description": "Filter by one or more official INSEE company-size categories (OR match).", "items": { "type": "string", "enum": [ "PME", "ETI", "GE" ], "enumTitles": [ "PME - Small/medium enterprise", "ETI - Mid-size enterprise", "GE - Large enterprise" ] }, "default": [] }, "etatAdministratif": { "title": "Company status", "enum": [ "", "A", "C" ], "type": "string", "description": "Filter by whether the company is currently active or has ceased trading.", "default": "" }, "departement": { "title": "Department (mode=search)", "type": "array", "description": "Filter to one or more French administrative departments (OR match).", "items": { "type": "string", "enum": [ "01", "02", "03", "04", "05", "06", "07", "08", "09", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "2A", "2B", "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", "971", "972", "973", "974", "976" ], "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", "2A - Corse-du-Sud", "2B - Haute-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", "971 - Guadeloupe", "972 - Martinique", "973 - Guyane", "974 - La Réunion", "976 - Mayotte" ] }, "default": [] }, "codePostal": { "title": "Postal code (mode=search)", "type": "string", "description": "Filter to an exact 5-digit French postal code, e.g. `75001`. Comma-separate for multiple codes." }, "region": { "title": "Region", "type": "array", "description": "Filter by one or more French administrative regions (OR match). Applied server-side for mode=search; applied client-side for mode=byIds/nearPoint.", "items": { "type": "string", "enum": [ "11", "24", "27", "28", "32", "44", "52", "53", "75", "76", "84", "93", "94", "01", "02", "03", "04", "06" ], "enumTitles": [ "11 - Île-de-France", "24 - Centre-Val de Loire", "27 - Bourgogne-Franche-Comté", "28 - Normandie", "32 - Hauts-de-France", "44 - Grand Est", "52 - Pays de la Loire", "53 - Bretagne", "75 - Nouvelle-Aquitaine", "76 - Occitanie", "84 - Auvergne-Rhône-Alpes", "93 - Provence-Alpes-Côte d'Azur", "94 - Corse", "01 - Guadeloupe", "02 - Martinique", "03 - Guyane", "04 - La Réunion", "06 - Mayotte" ] }, "default": [] }, "codeCommune": { "title": "INSEE commune code", "type": "string", "description": "Filter to an exact INSEE commune (municipality) code, e.g. `75101` for Paris 1st arrondissement. Comma-separate for multiple codes. Applied server-side for mode=search; applied client-side for mode=byIds/nearPoint." }, "natureJuridique": { "title": "Legal form code", "type": "string", "description": "Filter by official INSEE legal-form code (\"nature juridique\"), e.g. `5710` for SARL, `5599` for SA. Comma-separate for multiple codes. See INSEE's nomenclature for the full list. Applied server-side for mode=search; applied client-side for mode=byIds/nearPoint." }, "executiveName": { "title": "Executive/officer last name", "type": "string", "description": "Find companies with a director, manager, or elected officer whose last name matches (partial match). Applied server-side for mode=search; applied client-side for mode=byIds/nearPoint." }, "executiveFirstName": { "title": "Executive/officer first name", "type": "string", "description": "Find companies with a director, manager, or elected officer whose first name matches (partial match). Combine with `executiveName` for precision. Applied server-side for mode=search; applied client-side for mode=byIds/nearPoint." }, "executiveType": { "title": "Executive/officer role type (mode=search)", "enum": [ "", "dirigeant", "elu" ], "type": "string", "description": "Restrict the executive-name search to company officers or elected public officials.", "default": "" }, "employeeRange": { "title": "Employee headcount band", "type": "array", "description": "Filter by one or more official INSEE employee-headcount ranges (\"tranche d'effectif salarié\") (OR match). Applied server-side for mode=search; applied client-side for mode=byIds/nearPoint.", "items": { "type": "string", "enum": [ "00", "01", "02", "03", "11", "12", "21", "22", "31", "32", "41", "42", "51", "52", "53" ], "enumTitles": [ "0 employees", "1-2 employees", "3-5 employees", "6-9 employees", "10-19 employees", "20-49 employees", "50-99 employees", "100-199 employees", "200-249 employees", "250-499 employees", "500-999 employees", "1,000-1,999 employees", "2,000-4,999 employees", "5,000-9,999 employees", "10,000+ employees" ] }, "default": [] }, "onlyEmployers": { "title": "Employers only", "type": "boolean", "description": "Only companies that employ staff.", "default": false }, "onlyIndividualEntrepreneurs": { "title": "Sole proprietorships only", "type": "boolean", "description": "Only individual/sole-proprietor businesses (auto-entrepreneurs).", "default": false }, "onlyAssociations": { "title": "Associations only", "type": "boolean", "description": "Only non-profit associations.", "default": false }, "onlyOrganic": { "title": "Organic-certified only", "type": "boolean", "description": "Only companies certified by the French organic-farming agency (Agence Bio).", "default": false }, "onlySocialSolidarityEconomy": { "title": "Social & solidarity economy only", "type": "boolean", "description": "Only companies belonging to the social & solidarity economy (ESS) sector.", "default": false }, "onlyQualiopiCertified": { "title": "Qualiopi-certified only", "type": "boolean", "description": "Only companies certified under the French \"Qualiopi\" training-quality mark.", "default": false }, "onlyRGECertified": { "title": "RGE-certified only", "type": "boolean", "description": "Only companies recognized as \"Reconnu Garant de l'Environnement\" (RGE) for energy-efficiency works.", "default": false }, "onlyAlimConfianceInspected": { "title": "Food-safety inspected only", "type": "boolean", "description": "Only companies with a published \"Alim'confiance\" food-safety inspection result.", "default": false }, "onlyResponsiblePurchasing": { "title": "Responsible purchasing label only", "type": "boolean", "description": "Only companies holding the \"Relations Fournisseurs et Achats Responsables\" (RFAR) label.", "default": false }, "onlyLivingHeritageCompany": { "title": "Living Heritage Company only", "type": "boolean", "description": "Only companies holding the \"Entreprise du Patrimoine Vivant\" (EPV) label for craftsmanship/industrial excellence.", "default": false }, "onlySocialInclusionEnterprise": { "title": "Work-integration social enterprise only", "type": "boolean", "description": "Only \"Structures d'Insertion par l'Activité Économique\" (SIAE) — work-integration social enterprises.", "default": false }, "onlyTrainingOrganization": { "title": "Training organization only", "type": "boolean", "description": "Only companies registered as a vocational-training provider.", "default": false }, "onlyEntertainmentLicense": { "title": "Live-entertainment license only", "type": "boolean", "description": "Only companies holding a live-performance/entertainment producer license.", "default": false }, "onlyMissionDrivenCompany": { "title": "Mission-driven company only", "type": "boolean", "description": "Only \"société à mission\" companies with a legally stated social/environmental purpose.", "default": false }, "onlyPublicAdministration": { "title": "Public administration only", "type": "boolean", "description": "Only entities recognized as public administration bodies.", "default": false }, "epci": { "title": "EPCI code (mode=search)", "type": "string", "description": "Filter by intermunicipal grouping (\"EPCI\") SIREN code. Comma-separate for multiple codes." }, "collectiviteTerritorialeCode": { "title": "Local government body code (mode=search)", "type": "string", "description": "Filter to an exact local government body — commune (INSEE code), EPCI (SIREN), department (INSEE code + \"D\"), or region (INSEE code)." }, "idFiness": { "title": "FINESS geographic identifier (mode=search)", "type": "string", "description": "Find the company operating the healthcare facility with this exact FINESS geographic identifier (9 digits)." }, "idRge": { "title": "RGE identifier (mode=search)", "type": "string", "description": "Find the company holding this exact \"Reconnu Garant de l'Environnement\" (RGE) certification identifier." }, "idUai": { "title": "UAI identifier (mode=search)", "type": "string", "description": "Find the company/institution with this exact educational-institution identifier (UAI)." }, "idConventionCollective": { "title": "Collective agreement ID (IDCC) (mode=search)", "type": "string", "description": "Filter to companies bound by this exact collective-bargaining agreement identifier (IDCC), e.g. `1979`." }, "executiveBirthDateMin": { "title": "Executive/officer birth date from (mode=search)", "type": "string", "description": "Only include companies with a director, manager, or elected officer born on or after this date (YYYY-MM-DD)." }, "executiveBirthDateMax": { "title": "Executive/officer birth date to (mode=search)", "type": "string", "description": "Only include companies with a director, manager, or elected officer born on or before this date (YYYY-MM-DD)." }, "onlyLocalGovernment": { "title": "Local government bodies only", "type": "boolean", "description": "Only territorial/local government entities (municipalities, departments, regions, EPCIs).", "default": false }, "onlyEducationalInstitution": { "title": "Educational institution only", "type": "boolean", "description": "Only entities with a registered educational-institution identifier (UAI).", "default": false }, "onlyHealthcareFacility": { "title": "Healthcare facility only", "type": "boolean", "description": "Only entities with a registered healthcare-facility identifier (FINESS).", "default": false }, "onlyGenderEqualityIndexDisclosed": { "title": "Gender-equality index disclosed only", "type": "boolean", "description": "Only companies that published their professional gender-equality index (Egapro).", "default": false }, "onlyCollectiveAgreementDisclosed": { "title": "Collective agreement disclosed only", "type": "boolean", "description": "Only companies with a declared collective-bargaining agreement (convention collective).", "default": false }, "onlyLawyer": { "title": "Lawyers only", "type": "boolean", "description": "Only firms listed in the French national bar's lawyer directory (Annuaire des avocats de France).", "default": false }, "onlyGHGReportDisclosed": { "title": "Carbon footprint report disclosed only", "type": "boolean", "description": "Only companies that published a greenhouse-gas emissions report (Bilan GES).", "default": false }, "onlyReceivedMinimisAid": { "title": "Received de minimis state aid only", "type": "boolean", "description": "Only companies recorded as having received \"de minimis\" state aid.", "default": false }, "onlyReceivedAdemeAid": { "title": "Received ADEME aid only", "type": "boolean", "description": "Only companies recorded as having received aid from ADEME, the French environment/energy agency.", "default": false }, "minRevenue": { "title": "Min annual revenue (EUR)", "minimum": 0, "maximum": 500000000000, "type": "integer", "description": "Drop companies with reported annual revenue below this amount." }, "maxRevenue": { "title": "Max annual revenue (EUR)", "minimum": 0, "maximum": 500000000000, "type": "integer", "description": "Drop companies with reported annual revenue above this amount." }, "minNetIncome": { "title": "Min annual net income (EUR)", "minimum": -500000000000, "maximum": 500000000000, "type": "integer", "description": "Drop companies with reported annual net income below this amount. Can be negative to include/require losses." }, "maxNetIncome": { "title": "Max annual net income (EUR)", "minimum": -500000000000, "maximum": 500000000000, "type": "integer", "description": "Drop companies with reported annual net income above this amount." }, "sortBySize": { "title": "Sort by company size", "type": "boolean", "description": "Sort results by number of establishments (largest first) instead of text relevance.", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on emitted records.", "default": 20 } } }, "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 } } } } } } } } } }