{ "openapi": "3.0.1", "info": { "title": "Sirene French Company Scraper — SIREN, NAF, Directors", "description": "Scrape the official French Sirene company register: SIREN, SIRET, NAF activity code, head-office address with GPS, headcount band, VAT number, creation date and registered directors. Filter by activity, department, postcode or creation date. No login, no API key.", "version": "0.1", "x-build-id": "oa7aaXKaBhP1NJx2I" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapersdelight~sirene-company-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapersdelight-sirene-company-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/scrapersdelight~sirene-company-scraper/runs": { "post": { "operationId": "runs-sync-scrapersdelight-sirene-company-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/scrapersdelight~sirene-company-scraper/run-sync": { "post": { "operationId": "run-sync-scrapersdelight-sirene-company-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", "properties": { "query": { "title": "Search term", "type": "string", "description": "Free-text search: company name, trade name, SIREN or SIRET. Combine with the filters below or use it on its own." }, "nafCodes": { "title": "NAF / APE activity codes", "type": "array", "description": "French activity codes, e.g. 10.71C (bakery), 56.10C (fast food), 62.01Z (software). Each code is searched separately, so several codes multiply the run.", "default": [], "items": { "type": "string" } }, "departments": { "title": "Departments", "type": "array", "description": "Two-digit French department codes, e.g. 75 (Paris), 13 (Bouches-du-Rhone), 2A (Corse-du-Sud). Each is searched separately.", "default": [], "items": { "type": "string" } }, "postalCodes": { "title": "Postal codes", "type": "array", "description": "Exact postal codes, e.g. 75001. Used only when no department is given.", "default": [], "items": { "type": "string" } }, "createdAfter": { "title": "Created on or after", "type": "string", "description": "YYYY-MM-DD. Combine with an activity code, department or search term to get a new-business feed. The API rejects a date-only query.", "default": "" }, "createdBefore": { "title": "Created on or before", "type": "string", "description": "YYYY-MM-DD.", "default": "" }, "companyStatus": { "title": "Company status", "enum": [ "active", "closed", "all" ], "type": "string", "description": "Active companies (default), companies that have closed (a business-closures feed, with the closure date), or both.", "default": "active" }, "employersOnly": { "title": "Employers only", "type": "boolean", "description": "Keep only companies registered as having employees. Filters out the very large tail of one-person micro-entreprises.", "default": false }, "includeDirigeants": { "title": "Include directors", "type": "boolean", "description": "Add the company's registered officers (name, role, birth year) from the RNE. These are public register records but still personal data — use them lawfully.", "default": true }, "includeEstablishments": { "title": "Include all establishments", "type": "boolean", "description": "Add every matching establishment (SIRET, address, GPS) as a nested array, not just the head office. Makes rows much larger.", "default": false }, "includeNonDiffusible": { "title": "Include non-diffusible records", "type": "boolean", "description": "INSEE lets a company opt out of redistribution. Those records are skipped by default. Only switch this on if you have a lawful basis.", "default": false }, "maxItems": { "title": "Maximum companies", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Stop after this many companies. 0 = unlimited. Note the API caps ANY single search at 10,000 results — slice by activity code, department or creation date to go beyond that.", "default": 200 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. This is an open government API with no anti-bot, so a proxy is not needed and only adds cost. Leave empty unless your network requires one." } } }, "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 } } } } } } } } } }