{ "openapi": "3.0.1", "info": { "title": "France Company List – SIRENE B2B Leads, SIREN & SIRET", "description": "Build French company lists (B2B leads) from the official SIRENE / INSEE register: filter by NAF/APE code, département, headcount, revenue and labels (RGE, Qualiopi). SIREN, SIRET, VAT, address, revenue. Annuaire des entreprises data, no scraping, no personal data. MCP-ready.", "version": "1.0", "x-build-id": "4vUTJtPlRUxPjvXWg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ostrata~france-company-list/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ostrata-france-company-list", "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/ostrata~france-company-list/runs": { "post": { "operationId": "runs-sync-ostrata-france-company-list", "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/ostrata~france-company-list/run-sync": { "post": { "operationId": "run-sync-ostrata-france-company-list", "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", "type": "array", "description": "NAF rev.2 activity codes, e.g. 62.01Z (software), 43.22B (heating/plumbing), 70.22Z (consulting). \"6201Z\" also works.", "items": { "type": "string" } }, "sections": { "title": "Activity sections", "uniqueItems": true, "type": "array", "description": "Broad NAF sections (A to U). Use NAF codes for precise targeting.", "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, fishing", "B – Mining", "C – Manufacturing", "D – Energy", "E – Water, waste", "F – Construction", "G – Wholesale & retail, car repair", "H – Transport & storage", "I – Accommodation & food", "J – Information & communication", "K – Finance & insurance", "L – Real estate", "M – Professional, scientific & technical", "N – Administrative & support", "O – Public administration", "P – Education", "Q – Health & social work", "R – Arts & recreation", "S – Other services", "T – Households as employers", "U – Extraterritorial" ] } }, "departements": { "title": "Départements", "type": "array", "description": "Département codes, e.g. 54, 75, 2A, 974.", "items": { "type": "string" } }, "regions": { "title": "Regions (INSEE codes)", "type": "array", "description": "2-digit INSEE region codes, e.g. 11 Île-de-France, 44 Grand Est, 84 Auvergne-Rhône-Alpes.", "items": { "type": "string" } }, "postalCodes": { "title": "Postal codes", "type": "array", "description": "5-digit postal codes, e.g. 54000.", "items": { "type": "string" } }, "communes": { "title": "Communes (INSEE codes)", "type": "array", "description": "5-character INSEE commune codes (not postal codes), e.g. 54395 for Nancy.", "items": { "type": "string" } }, "geoMatch": { "title": "Location means", "enum": [ "head_office", "any_establishment" ], "type": "string", "description": "How the area filters apply. The register matches companies that have any establishment in the area. \"Head office\" keeps only companies headquartered there. Rows dropped by this filter are free.", "default": "head_office" }, "employeeBands": { "title": "Headcount bands", "type": "array", "description": "INSEE headcount bands (salaried staff, latest year known).", "items": { "type": "string", "enum": [ "00", "01", "02", "03", "11", "12", "21", "22", "31", "32", "41", "42", "51", "52", "53", "NN" ], "enumTitles": [ "0 employees", "1-2", "3-5", "6-9", "10-19", "20-49", "50-99", "100-199", "200-249", "250-499", "500-999", "1000-1999", "2000-4999", "5000-9999", "10000+", "Not an employer / unknown" ] } }, "companyCategories": { "title": "Company size category", "type": "array", "description": "INSEE category: PME (SME), ETI (mid-cap), GE (large).", "items": { "type": "string", "enum": [ "PME", "ETI", "GE" ], "enumTitles": [ "PME – SME", "ETI – mid-size", "GE – large company" ] } }, "legalForms": { "title": "Legal form codes", "type": "array", "description": "4-digit INSEE legal form codes, e.g. 5710 SAS, 5720 SASU, 5499 SARL, 5498 EURL, 5599 SA.", "items": { "type": "string" } }, "labels": { "title": "Labels & certifications", "type": "array", "description": "Only companies holding all selected labels.", "items": { "type": "string", "enum": [ "rge", "qualiopi", "organisme_formation", "bio", "ess", "societe_mission", "siae", "patrimoine_vivant", "achats_responsables", "egapro", "entrepreneur_spectacle", "finess", "association" ], "enumTitles": [ "RGE (energy renovation certified)", "Qualiopi (training quality)", "Registered training provider", "Organic (Agence Bio)", "Social & solidarity economy (ESS)", "Société à mission", "Work-integration enterprise (SIAE)", "Living Heritage Company (EPV)", "Responsible purchasing label (RFAR)", "Gender-equality index published (Egapro)", "Live-entertainment licence", "Health & social sector (FINESS)", "Associations only" ] } }, "minRevenue": { "title": "Minimum revenue (€)", "minimum": 0, "type": "integer", "description": "Latest published turnover (chiffre d'affaires). Only companies that publish accounts can match." }, "maxRevenue": { "title": "Maximum revenue (€)", "minimum": 0, "type": "integer", "description": "Latest published turnover." }, "minNetIncome": { "title": "Minimum net income (€)", "type": "integer", "description": "Latest published net result (can be negative)." }, "maxNetIncome": { "title": "Maximum net income (€)", "type": "integer", "description": "Latest published net result." }, "createdAfter": { "title": "Created on or after", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "Company creation date, YYYY-MM-DD. Applied after retrieval; rows dropped are free." }, "createdBefore": { "title": "Created on or before", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "Company creation date, YYYY-MM-DD." }, "keywords": { "title": "Keywords (optional)", "type": "string", "description": "Free text matched against company names and addresses, e.g. \"logiciel\" or \"boulangerie\"." }, "activeOnly": { "title": "Active companies only", "type": "boolean", "description": "Exclude companies that have ceased trading.", "default": true }, "excludeSoleProprietors": { "title": "Exclude sole traders", "type": "boolean", "description": "Sole traders (entrepreneurs individuels) are natural persons. When off, they are included but their name, street address and coordinates are removed (personal data).", "default": true }, "includeMatchingEstablishments": { "title": "Include matching establishments", "type": "boolean", "description": "Add up to 5 establishments (SIRET, address, NAF) per company that match the area filter.", "default": false }, "sortBySize": { "title": "Largest companies first", "type": "boolean", "description": "Sort by number of establishments instead of relevance.", "default": false }, "maxResults": { "title": "Maximum companies", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many companies (each delivered company is one billable event). Above 10 000 matches without an area filter, the Actor continues département by département.", "default": 100 } } }, "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 } } } } } } } } } }