{ "openapi": "3.0.1", "info": { "title": "France Company Search: SIRENE Companies by NAF, SIREN", "description": "Search French companies in the official SIRENE register (INSEE data via recherche-entreprises.api.gouv.fr). Filter by name, NAF/APE code, region, department, headcount, legal form or revenue, or look up SIREN/SIRET. NAF labels, finances, establishments. JSON, CSV or Excel. No API key.", "version": "0.1", "x-build-id": "fDaus1KfgPSTXOzgs" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nexus-scrapers~france-company-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nexus-scrapers-france-company-search", "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/nexus-scrapers~france-company-search/runs": { "post": { "operationId": "runs-sync-nexus-scrapers-france-company-search", "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/nexus-scrapers~france-company-search/run-sync": { "post": { "operationId": "run-sync-nexus-scrapers-france-company-search", "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": { "query": { "title": "Search text", "type": "string", "description": "Company name, brand, address or other text (3 characters minimum). The register also matches director names in free text, so do not use this field to look up private individuals. Leave empty to search by filters only." }, "identifiers": { "title": "SIREN / SIRET list", "type": "array", "description": "Look up specific companies by SIREN (9 digits) or SIRET (14 digits; returns the company that owns the establishment). Filters below are NOT applied to these lookups, so ceased companies are returned too. Can be combined with a search.", "items": { "type": "string" } }, "nafCodes": { "title": "NAF / APE activity codes", "type": "array", "description": "NAF rev. 2 codes or prefixes ('62' = all IT, '62.0', '62.01Z'). NAF 2025 codes are also accepted and translated to the rev. 2 codes the register filters on. Matches the company's main activity.", "items": { "type": "string" } }, "departments": { "title": "Departments", "type": "array", "description": "Department codes ('75', '2A', '971') or names. Matches companies with at least one establishment there (not necessarily the head office).", "items": { "type": "string" } }, "regions": { "title": "Regions", "type": "array", "description": "Regions. Matches companies with at least one establishment in the region.", "items": { "type": "string", "enum": [ "01", "02", "03", "04", "06", "11", "24", "27", "28", "32", "44", "52", "53", "75", "76", "84", "93", "94" ], "enumTitles": [ "Guadeloupe (01)", "Martinique (02)", "Guyane (03)", "La Réunion (04)", "Mayotte (06)", "Île-de-France (11)", "Centre-Val de Loire (24)", "Bourgogne-Franche-Comté (27)", "Normandie (28)", "Hauts-de-France (32)", "Grand Est (44)", "Pays de la Loire (52)", "Bretagne (53)", "Nouvelle-Aquitaine (75)", "Occitanie (76)", "Auvergne-Rhône-Alpes (84)", "Provence-Alpes-Côte d'Azur (93)", "Corse (94)" ] } }, "postalCodes": { "title": "Postal codes", "type": "array", "description": "5-digit postal codes (establishment level).", "items": { "type": "string" } }, "communeCodes": { "title": "INSEE commune codes", "type": "array", "description": "5-character INSEE municipality codes (establishment level).", "items": { "type": "string" } }, "companyCategories": { "title": "Company size category", "type": "array", "description": "INSEE category: PME (small and medium), ETI (mid-cap), GE (large). Not all companies have one.", "items": { "type": "string", "enum": [ "PME", "ETI", "GE" ], "enumTitles": [ "PME - small and medium enterprise", "ETI - mid-cap", "GE - large enterprise" ] } }, "employeeBands": { "title": "Employee bands", "type": "array", "description": "INSEE workforce bands of the company.", "items": { "type": "string", "enum": [ "00", "01", "02", "03", "11", "12", "21", "22", "31", "32", "41", "42", "51", "52", "53", "NN" ], "enumTitles": [ "0 salarié (n'ayant pas d'effectif au 31/12 mais ayant employé des salariés au cours de l'année de référence) (00)", "1 ou 2 salariés (01)", "3 à 5 salariés (02)", "6 à 9 salariés (03)", "10 à 19 salariés (11)", "20 à 49 salariés (12)", "50 à 99 salariés (21)", "100 à 199 salariés (22)", "200 à 249 salariés (31)", "250 à 499 salariés (32)", "500 à 999 salariés (41)", "1 000 à 1 999 salariés (42)", "2 000 à 4 999 salariés (51)", "5 000 à 9 999 salariés (52)", "10 000 salariés et plus (53)", "Unité non employeuse (pas de salarié au cours de l'année de référence et pas d'effectif au 31/12) (NN)" ] } }, "legalForms": { "title": "Legal form codes", "type": "array", "description": "INSEE legal category codes (4 digits), for example 5710 = SAS, 5499 = SARL, 5599 = SA, 1000 = sole trader, 9220 = association.", "items": { "type": "string" } }, "labels": { "title": "Labels and statuses (all must apply)", "type": "array", "description": "Only companies with these labels, for example RGE, organic, ESS, mission company.", "items": { "type": "string", "enum": [ "ess", "rge", "bio", "association", "societe-mission", "qualiopi", "siae", "organisme-formation", "patrimoine-vivant", "finess", "uai", "collectivite-territoriale", "achats-responsables", "alim-confiance", "entrepreneur-spectacle", "administration" ], "enumTitles": [ "ESS - Social and solidarity economy", "RGE - Recognised environmental guarantor", "Organic (Agence Bio certified establishment)", "Association", "Societe a mission (purpose-driven company)", "Qualiopi certified training body", "SIAE - Work-integration structure", "Registered training organisation", "Entreprise du Patrimoine Vivant (EPV)", "Health and social sector (FINESS)", "Education (UAI establishment)", "Local authority", "Responsible purchasing label (RFAR)", "Alim'confiance food-safety inspection result", "Performing-arts entrepreneur licence", "Public administration (not exhaustive)" ] } }, "minRevenue": { "title": "Minimum revenue (EUR)", "minimum": 0, "type": "integer", "description": "Latest published revenue, in euros. Only companies that publish accounts have one." }, "maxRevenue": { "title": "Maximum revenue (EUR)", "minimum": 0, "type": "integer", "description": "Latest published revenue, in euros." }, "minNetResult": { "title": "Minimum net result (EUR)", "type": "integer", "description": "Latest published net result, in euros (can be negative)." }, "maxNetResult": { "title": "Maximum net result (EUR)", "type": "integer", "description": "Latest published net result, in euros." }, "activeOnly": { "title": "Active companies only", "type": "boolean", "description": "Exclude ceased companies (applies to searches, not to SIREN/SIRET lookups).", "default": true }, "excludeSoleTraders": { "title": "Exclude sole traders", "type": "boolean", "description": "Leave out entrepreneurs individuels, whose registered business name is the name of a natural person.", "default": false }, "excludeCommercialOpposition": { "title": "Exclude companies that opposed commercial use", "type": "boolean", "description": "INSEE lets businesses object to the use of their data for commercial prospecting (flag commercialUseOpposition). Tick this if you will use the results for marketing or prospecting. The flag is always included in the output.", "default": false }, "sortBySize": { "title": "Largest first", "type": "boolean", "description": "Sort by number of establishments instead of relevance.", "default": false }, "includeEstablishments": { "title": "Include establishments", "type": "boolean", "description": "Add an 'establishments' list to each company with the establishments that match your filters (all establishments, up to the limit below, when no location filter is set).", "default": false }, "maxEstablishmentsPerCompany": { "title": "Max establishments per company", "minimum": 1, "maximum": 100, "type": "integer", "description": "Upper limit of the establishments list (1-100).", "default": 10 }, "includeDirectors": { "title": "Include natural-person directors (GDPR: you are the controller)", "type": "boolean", "description": "OFF by default. When ticked, each record also gets a 'directors' list with the name, role, birth month/year and nationality of natural-person directors as published in the French register (RNE). Company directors (auditors, parent companies) are always included. By enabling this you act as the data controller for that personal data under the GDPR and must have your own lawful basis, purpose and information duties; this Actor does not provide legal advice. Directors of companies in partial diffusion are never returned.", "default": false }, "maxItems": { "title": "Maximum results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of companies to return. You are charged per result, so keep this low while testing. The register serves at most 10,000 results per search: split larger extractions by department or NAF code.", "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }