{ "openapi": "3.0.1", "info": { "title": "French Companies · Search & SIREN Enrich", "description": "Paste a Pappers or data.gouv URL or SIREN list — export-ready rows: directors, VAT, addresses, NAF, finances where published. Public INSEE register. No API key.", "version": "2.26", "x-build-id": "wQzuTMDl09AfNGBls" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/corent1robert~recherche-entreprises-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-corent1robert-recherche-entreprises-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/corent1robert~recherche-entreprises-scraper/runs": { "post": { "operationId": "runs-sync-corent1robert-recherche-entreprises-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/corent1robert~recherche-entreprises-scraper/run-sync": { "post": { "operationId": "run-sync-corent1robert-recherche-entreprises-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "searchUrl", "sirens" ], "type": "string", "description": "**Search URL** — paste a filter/search link; we fetch matching companies.\n\n**SIREN list** — paste 9-digit IDs; we enrich each one.", "default": "searchUrl" }, "searchUrls": { "title": "Search URLs", "type": "array", "description": "Paste **full search links** from Pappers, Societe.com, or data.gouv (one per line). **Required** when **Mode** is Search URL. In SIREN mode, plain SIREN digits here are used only when **SIREN numbers** is empty.", "items": { "type": "string" } }, "sirens": { "title": "SIREN numbers", "type": "array", "description": "Paste **one SIREN per line** (9 digits). **Required** when **Mode** is SIREN list.", "items": { "type": "string" } }, "maxResults": { "title": "Max companies — set 0 for all", "minimum": 0, "type": "integer", "description": "Maximum companies to collect **per search URL**. If omitted, **25** is used for a quick preview. Set to **0** to fetch every match (no cap — longer runs, increase **timeout** in Run options if needed). Ignored in SIREN mode.", "default": 25 }, "requireDirigeant": { "title": "Require at least one director", "type": "boolean", "description": "Exclude companies with **no named director** in the register. Leave **on** for outreach-ready lists; turn **off** for raw KYB exports.", "default": true }, "requireDirigeantPhysique": { "title": "Natural persons only (no holdings)", "type": "boolean", "description": "Exclude companies whose **primary director** has **no usable birth year** (holdings, redacted entries). Leave **on** for outreach; turn **off** for full compliance extracts.", "default": true }, "excludeCategories": { "title": "Exclude company size categories", "type": "array", "description": "Multi-select — leave empty for **no size filter**. Typical prospecting: exclude **GE** and **ETI** to keep PME and unclassified companies.", "items": { "type": "string", "enum": [ "GE", "ETI", "PME" ], "enumTitles": [ "GE — Large enterprise", "ETI — Mid-market", "PME — Small & medium enterprise" ] } }, "dateCreationMin": { "title": "Created from", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Keep companies created **on or after** this day. Leave blank for no lower bound." }, "dateCreationMax": { "title": "Created until", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Keep companies created **on or before** this day. Leave blank for no upper bound." }, "effectifsMin": { "title": "Min employees", "minimum": 0, "type": "integer", "description": "Keep companies whose headcount band **overlaps** at least this many employees (e.g. `10` keeps 10–19, 20–49, …). Leave blank for no minimum. Merged with `effectifs_min` from a Pappers URL by intersection." }, "effectifsMax": { "title": "Max employees", "minimum": 0, "type": "integer", "description": "Keep companies whose headcount band **overlaps** at most this many employees (e.g. `49` drops 50+ bands). Leave blank for no maximum." }, "dirigeantAgeMin": { "title": "Director min age", "minimum": 18, "maximum": 100, "type": "integer", "description": "Include only companies whose **primary director** (`dirigeant_1`) is **at least** this age (e.g. `35`). Requires a real birth year — not `[NON-DIFFUSIBLE]`." }, "dirigeantAgeMax": { "title": "Director max age", "minimum": 18, "maximum": 100, "type": "integer", "description": "Include only companies whose **primary director** (`dirigeant_1`) is **at most** this age (e.g. `45`). Requires a real birth year — not `[NON-DIFFUSIBLE]`." }, "includeLastBodaccEvent": { "title": "Last BODACC notice (slower on large runs)", "type": "boolean", "description": "Adds `derniere_annonce_date`, `derniere_annonce_type`, and a bodacc.fr link per company. One extra HTTP call per saved row — fine for previews and small SIREN lists; leave off for `maxResults: 0` or thousands of rows. Full history: [BODACC Announcements Scraper](https://apify.com/corent1robert/bodacc-announcements-scraper).", "default": false } } }, "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 } } } } } } } } } }