{ "openapi": "3.0.1", "info": { "title": "French Companies API: SIRENE, SIREN, SIRET & NAF", "description": "France company lists from the official SIRENE / RNE register, no API key. Filter by NAF code, department, region, postcode, headcount, revenue and RGE, Qualiopi, organic labels. Local establishments, VAT, finances. No repeats between runs. No sole traders, SCI or director names. No emails or phones.", "version": "0.1", "x-build-id": "Xu0dfgoOjQiRsaBy3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/responsible_front_evw~france-companies-b2b-leads/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-responsible_front_evw-france-companies-b2b-leads", "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/responsible_front_evw~france-companies-b2b-leads/runs": { "post": { "operationId": "runs-sync-responsible_front_evw-france-companies-b2b-leads", "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/responsible_front_evw~france-companies-b2b-leads/run-sync": { "post": { "operationId": "run-sync-responsible_front_evw-france-companies-b2b-leads", "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": { "nafCodes": { "title": "NAF / APE codes (sector)", "type": "array", "description": "INSEE activity codes with the dot, for example 10.71C (bakery), 62.01Z (software), 43.22B (heating and plumbing), 56.10A (restaurants). Applies to the company's main activity.", "items": { "type": "string" } }, "sections": { "title": "Activity sections", "type": "array", "description": "Optional broad sectors: A agriculture, C manufacturing, F construction, G trade, H transport, I hotels and restaurants, J information and communication, K finance, L real estate, M professional services, N admin services, P education, Q health, R arts, S other services.", "items": { "type": "string" } }, "departments": { "title": "Departments", "type": "array", "description": "Two or three character department codes, for example 33 (Gironde), 69 (Rhone), 75 (Paris), 2A (Corse-du-Sud), 971 (Guadeloupe). Matches companies with at least one establishment there.", "items": { "type": "string" } }, "regions": { "title": "Regions", "type": "array", "description": "INSEE region codes, for example 11 (Ile-de-France), 84 (Auvergne-Rhone-Alpes), 75 (Nouvelle-Aquitaine), 76 (Occitanie), 93 (Provence-Alpes-Cote d'Azur), 32 (Hauts-de-France), 44 (Grand Est), 53 (Brittany), 52 (Pays de la Loire).", "items": { "type": "string" } }, "postalCodes": { "title": "Postcodes", "type": "array", "description": "Five-digit postcodes, for example 75011, 31000.", "items": { "type": "string" } }, "communeCodes": { "title": "Commune codes (INSEE)", "type": "array", "description": "Five-character INSEE commune codes (not postcodes), for example 33063 (Bordeaux).", "items": { "type": "string" } }, "query": { "title": "Search text", "type": "string", "description": "Optional words in the company name or address, or a SIREN/SIRET number." }, "headcountRanges": { "title": "Headcount ranges", "type": "array", "description": "INSEE codes: 00 (0), 01 (1-2), 02 (3-5), 03 (6-9), 11 (10-19), 12 (20-49), 21 (50-99), 22 (100-199), 31 (200-249), 32 (250-499), 41 (500-999), 42 (1000-1999), 51 (2000-4999), 52 (5000-9999), 53 (10000+), NN (non-employer).", "items": { "type": "string" } }, "companyCategories": { "title": "Company size category", "type": "array", "description": "PME (SME), ETI (mid-size) or GE (large).", "items": { "type": "string" } }, "legalForms": { "title": "Legal form codes", "type": "array", "description": "Optional INSEE legal category codes, for example 5710 (SAS), 5499 (SARL), 5720 (SASU), 5599 (SA), 9220 (association). Sole traders (1000) and real estate civil companies (SCI) are always left out.", "items": { "type": "string" } }, "revenueMin": { "title": "Minimum revenue (EUR)", "type": "integer", "description": "Only companies whose last published revenue is at least this. Companies without published accounts are left out when you use it." }, "revenueMax": { "title": "Maximum revenue (EUR)", "type": "integer", "description": "Only companies whose last published revenue is at most this." }, "netIncomeMin": { "title": "Minimum net income (EUR)", "type": "integer", "description": "Optional." }, "netIncomeMax": { "title": "Maximum net income (EUR)", "type": "integer", "description": "Optional." }, "createdAfter": { "title": "Created on or after", "type": "string", "description": "Optional date (YYYY-MM-DD). Keeps only companies created on or after it. The register cannot sort by date, so the Actor reads up to 'Maximum companies scanned' and you only pay for the ones kept." }, "onlyActive": { "title": "Only active companies", "type": "boolean", "description": "Leave out closed companies.", "default": true }, "onlyEmployers": { "title": "Only employers", "type": "boolean", "description": "Keep only companies whose head office has employees.", "default": false }, "onlyRge": { "title": "Only RGE certified (energy renovation)", "type": "boolean", "description": "Only RGE certified (energy renovation).", "default": false }, "onlyQualiopi": { "title": "Only Qualiopi certified (training)", "type": "boolean", "description": "Only Qualiopi certified (training).", "default": false }, "onlyOrganic": { "title": "Only organic certified (Agence Bio)", "type": "boolean", "description": "Only organic certified (Agence Bio).", "default": false }, "onlySocialEconomy": { "title": "Only social and solidarity economy (ESS)", "type": "boolean", "description": "Only social and solidarity economy (ESS).", "default": false }, "onlyAssociations": { "title": "Only associations", "type": "boolean", "description": "Only associations.", "default": false }, "onlyTrainingOrganisations": { "title": "Only training organisations", "type": "boolean", "description": "Only training organisations.", "default": false }, "onlyMissionCompanies": { "title": "Only 'societes a mission'", "type": "boolean", "description": "Only 'societes a mission'.", "default": false }, "sortBySize": { "title": "Biggest companies first", "type": "boolean", "description": "Sort by number of establishments.", "default": false }, "includeEstablishments": { "title": "Include local establishments", "type": "boolean", "description": "For each company, the establishments (shops, sites) that match your area and filters, with SIRET, address, sign, headcount and coordinates. Ideal when the head office is elsewhere.", "default": true }, "maxEstablishmentsPerCompany": { "title": "Maximum establishments per company", "minimum": 1, "maximum": 100, "type": "integer", "description": "From 1 to 100.", "default": 10 }, "onlyNewSinceLastRun": { "title": "Only new companies since the last run (alerts)", "type": "boolean", "description": "Remembers the companies already delivered for this same search and skips them, so you never pay twice for the same company. Use it with a schedule.", "default": false }, "maxItems": { "title": "Maximum companies", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop after this many companies. The official API returns at most 10,000 per search: narrow the filters for more.", "default": 100 }, "maxScannedCompanies": { "title": "Maximum companies scanned", "minimum": 25, "maximum": 10000, "type": "integer", "description": "Only used with 'Created on or after', 'Only employers' or alerts: how many companies to read to find the ones you want. You only pay for the companies delivered.", "default": 2000 }, "requestDelaySecs": { "title": "Pause between requests (seconds)", "minimum": 3, "type": "integer", "description": "Minimum 3, to be gentle with the public API (its limit is 7 per second). Lower values are raised to 3.", "default": 3 } } }, "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 } } } } } } } } } }