{
  "openapi": "3.0.1",
  "info": {
    "title": "French Company Search – SIREN, SIRET & NAF (Sirene)",
    "description": "Search French companies by name, SIREN, SIRET, NAF code, department or legal form in the open Sirene data. Legal entities only: no directors, no sole traders. Licence attribution in every record, optional new-or-changed mode.",
    "version": "0.1",
    "x-build-id": "yMK6C2G1TRZM1OVbG"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/far003~french-company-search-sirene/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-far003-french-company-search-sirene",
        "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/far003~french-company-search-sirene/runs": {
      "post": {
        "operationId": "runs-sync-far003-french-company-search-sirene",
        "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/far003~french-company-search-sirene/run-sync": {
      "post": {
        "operationId": "run-sync-far003-french-company-search-sirene",
        "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": {
          "queries": {
            "title": "Queries (company name, SIREN or SIRET)",
            "type": "array",
            "description": "Free text (a company name: every word you type must be a whole word of one of its names), a SIREN (9 digits), a SIRET (14 digits, spaces allowed) or a French VAT number (FR + 2-digit key + SIREN, read as its SIREN). SIREN and SIRET are checked with the Luhn algorithm: an invalid number gives a free \"invalid_identifier\" record, no request. A SIREN/SIRET of a sole trader or of a group of natural persons gives a free \"excluded_individual\" record without any data. A name search delivers only companies that have the words of the query in one of their own names (legal name, acronym, trade names); legal-form words (SA, SAS, SARL, SCI...) and \"societe\" are optional, so \"Danone SA\" finds DANONE; a name of several words is also searched written together (\"Total Energies\" also as \"TotalEnergies\"), and a name with a capital inside a word also apart (\"SaintGobain\" also as \"Saint Gobain\"); results found only through a company director are skipped for free. Leave empty to search with the filters below only.",
            "items": {
              "type": "string"
            }
          },
          "departments": {
            "title": "Department codes",
            "type": "array",
            "description": "For example 75, 13, 2A, 971. The search matches companies with an establishment in these departments.",
            "items": {
              "type": "string"
            }
          },
          "postalCodes": {
            "title": "Postal codes",
            "type": "array",
            "description": "5 digits, for example 75009 (a space inside, as in 69 001, is accepted).",
            "items": {
              "type": "string"
            }
          },
          "communeCodes": {
            "title": "INSEE commune codes",
            "type": "array",
            "description": "5 characters, for example 75109 (Paris 9e). The city codes of Paris (75056), Lyon (69123) and Marseille (13055) are replaced by the codes of their arrondissements.",
            "items": {
              "type": "string"
            }
          },
          "regions": {
            "title": "Region codes",
            "type": "array",
            "description": "INSEE region codes, for example 11 (Île-de-France), 93, 84.",
            "items": {
              "type": "string"
            }
          },
          "nafCodes": {
            "title": "NAF codes (APE)",
            "type": "array",
            "description": "NAF rev. 2 codes, for example 62.01Z: use the nafCode value of the records. NAF 2025 codes (the nafCodeNaf25 value, for example 70.10Y) are not accepted by the API yet and are refused before any request.",
            "items": {
              "type": "string"
            }
          },
          "nafSections": {
            "title": "NAF sections",
            "type": "array",
            "description": "Section letters A to U, for example J (information and communication).",
            "items": {
              "type": "string"
            }
          },
          "legalFormCodes": {
            "title": "Legal form codes",
            "type": "array",
            "description": "4-digit INSEE codes, for example 5710 (SAS), 5499 (SARL), 5599 (SA). Codes starting with 1 (sole traders) 2110, 2210, 2310, 2385 (groups of natural persons) and 2400, 2800, 2900, 9210 (no legal personality) are refused.",
            "items": {
              "type": "string"
            }
          },
          "companyCategories": {
            "title": "Company categories",
            "type": "array",
            "description": "PME (small and medium), ETI (mid-cap), GE (large).",
            "items": {
              "type": "string",
              "enum": [
                "PME",
                "ETI",
                "GE"
              ],
              "enumTitles": [
                "PME - small and medium",
                "ETI - mid-cap",
                "GE - large"
              ]
            }
          },
          "employeeRanges": {
            "title": "Employee range codes",
            "type": "array",
            "description": "INSEE codes: 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 (1,000-1,999), 51 (2,000-4,999), 52 (5,000-9,999), 53 (10,000+), NN (not an employer).",
            "items": {
              "type": "string"
            }
          },
          "status": {
            "title": "Administrative status",
            "enum": [
              "any",
              "active",
              "closed"
            ],
            "type": "string",
            "description": "Keep only active companies, only closed ones, or both. Direct SIREN/SIRET lookups are not filtered.",
            "default": "any"
          },
          "maxResultsPerQuery": {
            "title": "Maximum results per query",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "Companies taken from each query or filter search (privacy exclusions, name mismatches, duplicates and, in \"only new or changed\" mode, unchanged companies do not count). The API lists at most 10,000 companies per search; above that, the search is split automatically by department and then by NAF section.",
            "default": 20
          },
          "onlyNewOrChanged": {
            "title": "Only new or changed companies",
            "type": "boolean",
            "description": "Remembers, between runs, what was delivered for each SIREN, and delivers only companies never delivered before (\"new\") or whose data changed (\"changed\", with the list of changed fields). Unchanged companies are skipped, are not charged and do not use up the maximum above; at most 500 pages (12,500 results) are read per query in this mode, and the SUMMARY says when that ceiling stopped a search. The memory is shared by all your runs of this Actor, whatever the filters.",
            "default": false
          },
          "requestsPerSecond": {
            "title": "Requests per second",
            "minimum": 0.1,
            "maximum": 2,
            "type": "number",
            "description": "Speed towards the public API (official limit: 7 per second per IP, shared with other users of the same cloud network). Kept gentle on purpose: 2 is both the default and the maximum.",
            "default": 2
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}