{ "openapi": "3.0.1", "info": { "title": "French Companies · Search & SIREN Enrichment", "description": "Build B2B lead lists or CRM enrichment from France’s official company register. Search by pasted URL (Pappers or data.gouv) with NAF, region, and department filters—or paste SIRENs for full records. Returns identity, address, directors, headcount band, and more via recherche-entreprises.api.gouv.fr.", "version": "2.0", "x-build-id": "AXEcZaoD7fa4F9d1X" }, "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", "nearPoint" ], "type": "string", "description": "**Search URL** — Build or extend a **lead list**: we use your search link to fetch matching companies.\n\n**SIREN list** — **Enrich what you already have**: paste SIRENs and get full details for each.\n\n**Near a location** — Find all companies around a French city or custom GPS point.", "default": "searchUrl" }, "searchUrls": { "title": "Search URLs", "type": "array", "description": "Paste the **full search links** from Pappers or recherche-entreprises.data.gouv.fr (one per line). Duplicate companies are merged automatically.", "items": { "type": "string" }, "default": [ "https://recherche-entreprises.data.gouv.fr/search?activite_principale=66.22Z&etat_administratif=A&per_page=25" ] }, "sirens": { "title": "SIREN numbers", "type": "array", "description": "Paste **one SIREN per line** (9 digits). Short numbers are padded; duplicates are skipped.", "items": { "type": "string" }, "default": [ "732829320", "552032534", "380129866" ] }, "maxResults": { "title": "Max companies — set 0 for all", "minimum": 0, "type": "integer", "description": "Maximum companies to collect **per URL or geographic query**. Default is **25** for a quick preview. Set to **0** to fetch every match (no cap — longer runs, increase **timeout** in Run options if needed).", "default": 25 }, "nearCity": { "title": "City", "enum": [ "", "Paris", "Marseille", "Lyon", "Toulouse", "Nice", "Nantes", "Montpellier", "Strasbourg", "Bordeaux", "Lille", "Rennes", "Reims", "Saint-Étienne", "Toulon", "Le Havre", "Grenoble", "Dijon", "Angers", "Nîmes", "Aix-en-Provence", "Brest", "Limoges", "Clermont-Ferrand", "Amiens", "Tours", "Metz", "Caen", "Nancy", "Perpignan", "Rouen", "Poitiers", "Orléans", "Besançon", "Mulhouse", "Pau", "Lens", "Avignon", "Versailles", "Dunkerque", "Roubaix", "Tourcoing", "Mérignac", "Nanterre", "Montreuil" ], "type": "string", "description": "Pick a French city. The actor uses its centre coordinates automatically. Leave blank to use **Custom coordinates** instead.", "default": "Paris" }, "radiusKm": { "title": "Radius (km)", "minimum": 1, "maximum": 50, "type": "integer", "description": "Search radius in kilometres (1–50). Default is **5 km**.", "default": 5 }, "nearActivityCode": { "title": "Activity code (NAF/APE)", "type": "string", "description": "Optional — filter by NAF/APE code (e.g. `56.10A` for traditional restaurants, `86.21Z` for GPs). Leave empty to include all activities." }, "nearActiveOnly": { "title": "Active companies only", "type": "boolean", "description": "When enabled, only companies with an **active** administrative status are returned. Recommended for lead generation.", "default": true }, "latitude": { "title": "Latitude", "type": "number", "description": "Latitude of the centre point (e.g. `48.8566` for Paris)." }, "longitude": { "title": "Longitude", "type": "number", "description": "Longitude of the centre point (e.g. `2.3522` for Paris)." } } }, "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 } } } } } } } } } }