{ "openapi": "3.0.1", "info": { "title": "Pappers / Sirene Scraper: 26M French Companies SIREN/SIRET", "description": "Search 26M+ French companies from the official Sirene database. Get SIREN, SIRET, legal name, address, dirigeants, NAF code, finances, GPS coordinates. Text search, geo radius, batch SIREN lookup, 53 filters. For B2B prospecting, KYC verification, CRM enrichment, lead generation. $5/1K companies.", "version": "1.0", "x-build-id": "V5nJqh0xhYurSPZFW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dltik~pappers-sirene-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dltik-pappers-sirene-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/dltik~pappers-sirene-scraper/runs": { "post": { "operationId": "runs-sync-dltik-pappers-sirene-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/dltik~pappers-sirene-scraper/run-sync": { "post": { "operationId": "run-sync-dltik-pappers-sirene-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": { "mode": { "title": "Search mode", "enum": [ "search", "geo", "siren" ], "type": "string", "description": "search = text/filter search, geo = lat/lon/radius, siren = batch lookup by SIREN/SIRET list.", "default": "search" }, "query": { "title": "Text query", "type": "string", "description": "Free text. Searches name, address, dirigeant. Example: 'boulangerie Lyon', 'Anthropic', 'Bernard Arnault'." }, "sirens": { "title": "SIREN/SIRET batch list", "type": "array", "description": "List of SIREN (9 digits) or SIRET (14 digits) for batch lookup. Set mode=siren.", "items": { "type": "string" }, "default": [] }, "departement": { "title": "Department code", "type": "string", "description": "Two-digit department code (e.g. '75' for Paris, '69' for Rhône, '13' for Bouches-du-Rhône)." }, "code_postal": { "title": "Postal code", "type": "string", "description": "5-digit postal code (e.g. '75009', '69002')." }, "code_commune": { "title": "INSEE commune code", "type": "string", "description": "INSEE city code (different from postal code). E.g. '75109' for Paris 9th arrondissement." }, "region": { "title": "Region code", "type": "string", "description": "Two-digit region code (e.g. '11' for Île-de-France, '84' for Auvergne-Rhône-Alpes)." }, "activite_principale": { "title": "NAF code (activité principale)", "type": "string", "description": "NAF/APE code (e.g. '62.01Z' for software, '56.10A' for restaurants, '47.11D' for supermarkets)." }, "section_activite_principale": { "title": "NAF section", "type": "string", "description": "Single-letter NAF section (A=agriculture, C=manufacturing, F=construction, G=trade, J=info/comm, K=finance, M=consulting, Q=health)." }, "categorie_entreprise": { "title": "Company size category", "enum": [ "PME", "ETI", "GE" ], "type": "string", "description": "PME (small/medium), ETI (intermediate), GE (large enterprise)." }, "tranche_effectif_salarie": { "title": "Employee bracket", "type": "string", "description": "INSEE bracket code: 00=0, 01=1-2, 02=3-5, 03=6-9, 11=10-19, 12=20-49, 21=50-99, 22=100-199, 31=200-249, 32=250-499, 41=500-999, 42=1000-1999, 51=2000-4999, 52=5000-9999, 53=10000+." }, "etat_administratif": { "title": "Administrative status", "enum": [ "A", "C" ], "type": "string", "description": "A = Active, C = Ceased.", "default": "A" }, "nom_personne": { "title": "Dirigeant last name", "type": "string", "description": "Search by manager / director last name (e.g. 'ARNAULT')." }, "prenoms_personne": { "title": "Dirigeant first name", "type": "string", "description": "Search by manager / director first name." }, "type_personne": { "title": "Person type", "enum": [ "dirigeant", "elu" ], "type": "string", "description": "dirigeant (company manager) or elu (elected official)." }, "ca_min": { "title": "Revenue minimum (€)", "minimum": 0, "type": "integer", "description": "Filter by minimum CA (chiffre d'affaires) in euros. Only available for companies that filed accounts." }, "ca_max": { "title": "Revenue maximum (€)", "minimum": 0, "type": "integer", "description": "Filter by maximum CA in euros." }, "lat": { "title": "Latitude (geo mode)", "type": "number", "description": "Latitude for geo search. Use with mode=geo." }, "lon": { "title": "Longitude (geo mode)", "type": "number", "description": "Longitude for geo search. Use with mode=geo." }, "radiusKm": { "title": "Radius (km)", "minimum": 0.1, "maximum": 50, "type": "number", "description": "Search radius in km, max 50." }, "est_rge": { "title": "RGE certified only", "type": "boolean", "description": "Reconnu Garant de l'Environnement (eco-construction).", "default": false }, "est_qualiopi": { "title": "Qualiopi certified only", "type": "boolean", "description": "Companies with Qualiopi training certification.", "default": false }, "est_bio": { "title": "Bio certified only", "type": "boolean", "description": "Organic/bio certified companies (Agence Bio).", "default": false }, "est_ess": { "title": "Social economy only", "type": "boolean", "description": "Économie Sociale et Solidaire.", "default": false }, "est_association": { "title": "Associations only", "type": "boolean", "description": "Restrict to associations (loi 1901).", "default": false }, "est_organisme_formation": { "title": "Training orgs only", "type": "boolean", "description": "Companies registered as training organizations.", "default": false }, "est_societe_mission": { "title": "Mission-driven companies only", "type": "boolean", "description": "Société à mission (B-Corp equivalent).", "default": false }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Max companies to return. API caps total search at ~10,000 results per query.", "default": 100 }, "proxyConfig": { "title": "Proxy (rarely needed)", "type": "object", "description": "Optional Apify proxy. The API gouv has no anti-bot — proxy rarely needed unless your IP is rate-limited.", "default": { "useApifyProxy": 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 } } } } } } } } } }