{ "openapi": "3.0.1", "info": { "title": "SIRENE API: French Company Data by SIREN (Unofficial)", "description": "Search and filter French companies from INSEE SIRENE data: SIREN, NAF/APE activity code, legal form, size band, department, creation date and published turnover and net income where available. Open data, no API key. Company data only, no personal fields. Not affiliated with INSEE.", "version": "0.1", "x-build-id": "z73aY8EMZ8kUKPWU4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/graylabs~fr-companies/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-graylabs-fr-companies", "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/graylabs~fr-companies/runs": { "post": { "operationId": "runs-sync-graylabs-fr-companies", "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/graylabs~fr-companies/run-sync": { "post": { "operationId": "run-sync-graylabs-fr-companies", "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": "Company name or address", "type": "string", "description": "Optional. Words searched in company names and head-office addresses, e.g. 'boulangerie lyon'. Only companies whose own name, acronym or address contains every word are returned (the source also matches directors' names; those matches are dropped)." }, "activityCodes": { "title": "Activity codes (NAF/APE)", "type": "array", "description": "Optional. NAF rév. 2 codes such as 62.01Z (computer programming) or 56.10A (traditional restaurants). Matches companies with an establishment in that activity.", "default": [], "items": { "type": "string" } }, "activitySections": { "title": "Activity sections", "type": "array", "description": "Optional. NAF section letters A to U, e.g. J (information and communication), F (construction).", "default": [], "items": { "type": "string" } }, "departments": { "title": "Departments", "type": "array", "description": "Optional. Department codes such as 75, 69, 2A or 974. Each department is searched separately (the source returns at most 10,000 companies per search).", "default": [], "items": { "type": "string" } }, "postcodes": { "title": "Postcodes", "type": "array", "description": "Optional. 5-digit postcodes of an establishment, e.g. 75008.", "default": [], "items": { "type": "string" } }, "legalCategories": { "title": "Legal categories", "type": "array", "description": "Optional. INSEE catégorie juridique codes (3000 to 9999), e.g. 5710 (SAS), 5499 (SARL), 5599 (SA), 9220 (association). Sole traders (1000) and groupings without legal personality (2xxx) are never returned.", "default": [], "items": { "type": "string" } }, "companyCategories": { "title": "Company size categories", "type": "array", "description": "Optional. INSEE category: PME (SMEs), ETI (mid-caps), GE (large companies).", "items": { "type": "string", "enum": [ "PME", "ETI", "GE" ], "enumTitles": [ "PME (small and medium)", "ETI (mid-size)", "GE (large)" ] }, "default": [] }, "employeeBands": { "title": "Employee bands", "type": "array", "description": "Optional. INSEE tranche d'effectif codes, e.g. 11 (10-19 employees), 12 (20-49), 21 (50-99), 22 (100-199), 31 (200-249), 32 (250-499), 41 (500-999), 42 (1,000-1,999), 51 (2,000-4,999), 52 (5,000-9,999), 53 (10,000+), NN (unknown).", "default": [], "items": { "type": "string" } }, "minRevenue": { "title": "Minimum turnover (euros)", "type": "integer", "description": "Optional. Only companies whose latest published turnover (chiffre d'affaires) is at least this." }, "maxRevenue": { "title": "Maximum turnover (euros)", "type": "integer", "description": "Optional. Only companies whose latest published turnover is at most this." }, "status": { "title": "Status", "enum": [ "active", "ceased", "any" ], "type": "string", "description": "Active companies (default), ceased companies, or both.", "default": "active" }, "createdFrom": { "title": "Created from (YYYY-MM-DD)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Optional. Keep companies created on or after this date (filters the search results; it does not widen the 10,000 limit)." }, "createdTo": { "title": "Created to (YYYY-MM-DD)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Optional. Keep companies created on or before this date." }, "sirens": { "title": "SIREN numbers", "type": "array", "description": "Optional. Look up specific companies by 9-digit SIREN (up to 1,000). Other filters except Status and creation dates are ignored in this mode.", "default": [], "items": { "type": "string" } }, "includeFinancials": { "title": "Include published financials", "type": "boolean", "description": "Add published turnover and net income by year (INPI/BCE ratios), when available.", "default": true }, "addressDetail": { "title": "Address detail", "enum": [ "full", "commune" ], "type": "string", "description": "Full: street address and coordinates of the head office. Commune: postcode, commune, department and region only.", "default": "full" }, "personNamedCompanies": { "title": "Companies named after a person", "enum": [ "flag", "exclude" ], "type": "string", "description": "Some companies are named after a person (e.g. 'SCI DUPONT'). Flag (default): keep them with nameResemblesIndividual = true and without street address or coordinates. Exclude: leave them out.", "default": "flag" }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Stop after saving this many companies (each saved company is one charged result).", "default": 100 }, "maxRequests": { "title": "Max API requests", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Safety cap on API requests per run (25 companies per request). Default 1,000. Requests are paced at about 3 per second, below the API's limit of 7.", "default": 1000 } } }, "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 } } } } } } } } } }