{ "openapi": "3.0.1", "info": { "title": "France New Companies & BODACC Events (Official, SIRENE)", "description": "New French companies from the official BODACC journal, enriched with SIRET, NAF industry, employees and GPS from SIRENE. Also business sales, insolvencies, removals and changes. Filter by département, NAF code, activity. New-since-last-run leads. No key.", "version": "1.0", "x-build-id": "9evIRMBwOtuPEB4Dl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/yuvalstudios~france-new-companies/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-yuvalstudios-france-new-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/yuvalstudios~france-new-companies/runs": { "post": { "operationId": "runs-sync-yuvalstudios-france-new-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/yuvalstudios~france-new-companies/run-sync": { "post": { "operationId": "run-sync-yuvalstudios-france-new-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": { "eventTypes": { "title": "What to get", "type": "array", "description": "BODACC announcement types. Default: newly created companies.", "items": { "type": "string", "enum": [ "creation", "immatriculation", "vente", "collective", "radiation", "modification" ], "enumTitles": [ "New companies (creations)", "New registrations incl. moves", "Business sales & transfers", "Insolvency (receivership, liquidation)", "Removed from the register", "Changes (management, address, capital, dissolution)" ] }, "default": [ "creation" ] }, "daysBack": { "title": "Days back (if no dates set)", "minimum": 0, "maximum": 365, "type": "integer", "description": "Announcements published in the BODACC in the last N days.", "default": 7 }, "publishedFrom": { "title": "Published from (YYYY-MM-DD)", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "Start of the publication date range (overrides days back)." }, "publishedTo": { "title": "Published to (YYYY-MM-DD)", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "End of the publication date range." }, "departments": { "title": "Départements", "type": "array", "description": "French département numbers, e.g. 75 (Paris), 69 (Rhône), 13 (Bouches-du-Rhône), 2A. Leave empty for all of France.", "default": [], "items": { "type": "string" } }, "nafCodes": { "title": "Industry (NAF code prefixes)", "type": "array", "description": "Only companies whose official INSEE NAF activity code starts with one of these, e.g. 56 (restaurants), 43 (building trades), 62 (IT), 68 (real estate), 56.10A. Uses the SIRENE lookup.", "default": [], "items": { "type": "string" } }, "keyword": { "title": "Activity or name contains", "type": "string", "description": "Free-text search in the declared activity and name, e.g. boulangerie, restaurant, plomberie, conseil." }, "entityType": { "title": "Entity type", "enum": [ "companies", "soleTraders", "all" ], "type": "string", "description": "Companies only is the default (legal entities). Sole traders are individuals, so their records are personal data.", "default": "companies" }, "enrich": { "title": "Add SIRET, NAF industry, employees, GPS", "type": "boolean", "description": "Look up each SIREN in the official SIRENE directory (recherche-entreprises.api.gouv.fr). Very new companies may not be indexed yet.", "default": true }, "maxItems": { "title": "Max results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum rows to output. Each row is billed as one result.", "default": 100 }, "newSinceLastRun": { "title": "New since last run", "type": "boolean", "description": "Remember announcements already returned and output only new ones next time. Schedule daily for a lead feed.", "default": false }, "stateKey": { "title": "Memory key", "type": "string", "description": "Name of the memory used by 'new since last run'. Use a different key per saved search.", "default": "default" } } }, "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 } } } } } } } } } }