{
  "openapi": "3.0.1",
  "info": {
    "title": "SIRENE Scraper: French Companies by NAF, SIREN & SIRET",
    "description": "Every French company of a SIRENE segment, past the 10,000-result limit of the official search. Filter by NAF code, department, postal code, size, legal form, revenue and labels, or look up SIREN and SIRET numbers. Officers, accounts, new-company monitoring and webhook.",
    "version": "0.1",
    "x-build-id": "b1uZrzv5y6GT3RzqJ"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/alexmorain~sirene-company-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-alexmorain-sirene-company-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/alexmorain~sirene-company-scraper/runs": {
      "post": {
        "operationId": "runs-sync-alexmorain-sirene-company-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/alexmorain~sirene-company-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-alexmorain-sirene-company-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": {
          "nafCodes": {
            "title": "NAF / APE codes",
            "type": "array",
            "description": "Main activity of the company, NAF rev. 2 code like <code>10.71C</code> (or <code>1071C</code>). Several codes are combined with OR.",
            "items": {
              "type": "string"
            }
          },
          "sections": {
            "title": "NAF sections",
            "type": "array",
            "description": "Letter A to U of the NAF section, for example <code>C</code> for manufacturing.",
            "items": {
              "type": "string"
            }
          },
          "query": {
            "title": "Search text",
            "type": "string",
            "description": "Free text: company name, address, director name. Combined with the other filters."
          },
          "sirens": {
            "title": "SIREN or SIRET numbers",
            "type": "array",
            "description": "One lookup per line: 9-digit SIREN or 14-digit SIRET. Returns the company of that number, whatever the other filters.",
            "items": {
              "type": "string"
            }
          },
          "departments": {
            "title": "Departments",
            "type": "array",
            "description": "Codes like <code>35</code>, <code>2A</code>, <code>971</code>. <b>Matches any establishment</b> of the company, not only its head office: a company headquartered in Lille with a shop in Paris is returned for <code>75</code>. Each company is returned once.",
            "items": {
              "type": "string"
            }
          },
          "postalCodes": {
            "title": "Postal codes",
            "type": "array",
            "description": "5-digit codes like <code>75001</code>. Matches any establishment.",
            "items": {
              "type": "string"
            }
          },
          "communeCodes": {
            "title": "Commune codes (INSEE)",
            "type": "array",
            "description": "5-character INSEE codes like <code>75101</code> or <code>2A004</code>. Matches any establishment.",
            "items": {
              "type": "string"
            }
          },
          "regions": {
            "title": "Regions",
            "type": "array",
            "description": "INSEE region codes like <code>11</code> (Île-de-France) or <code>53</code> (Bretagne).",
            "items": {
              "type": "string"
            }
          },
          "latitude": {
            "title": "Latitude",
            "type": "number",
            "description": "With longitude and radius: companies with an establishment within the radius. Only NAF codes and sections can be combined with a radius search."
          },
          "longitude": {
            "title": "Longitude",
            "type": "number",
            "description": "See latitude."
          },
          "radiusKm": {
            "title": "Radius (km)",
            "type": "number",
            "description": "Up to 50 km. A radius search is capped at 10,000 companies by the source and cannot be split."
          },
          "employeeRanges": {
            "title": "Employee ranges",
            "type": "array",
            "description": "INSEE codes of the company's headcount range: <code>NN</code> no employer, <code>00</code> 0, <code>01</code> 1-2, <code>02</code> 3-5, <code>03</code> 6-9, <code>11</code> 10-19, <code>12</code> 20-49, <code>21</code> 50-99, <code>22</code> 100-199, <code>31</code> 200-249, <code>32</code> 250-499, <code>41</code> 500-999, <code>42</code> 1,000-1,999, <code>51</code> 2,000-4,999, <code>52</code> 5,000-9,999, <code>53</code> 10,000+.",
            "items": {
              "type": "string"
            }
          },
          "companyCategories": {
            "title": "Company categories",
            "type": "array",
            "description": "PME (small and medium), ETI (mid-cap) or GE (large).",
            "items": {
              "type": "string",
              "enum": [
                "PME",
                "ETI",
                "GE"
              ]
            }
          },
          "legalForms": {
            "title": "Legal forms (nature juridique)",
            "type": "array",
            "description": "INSEE codes like <code>5710</code> (SAS), <code>5499</code> (SARL), <code>1000</code> (sole trader), <code>9220</code> (association).",
            "items": {
              "type": "string"
            }
          },
          "excludeSoleTraders": {
            "title": "Exclude sole traders",
            "type": "boolean",
            "description": "Skip individual entrepreneurs (entreprises individuelles)."
          },
          "status": {
            "title": "Status",
            "enum": [
              "active",
              "closed",
              "all"
            ],
            "type": "string",
            "description": "<b>active</b>: companies still open (default). <b>closed</b>: ceased companies. <b>all</b>: both.",
            "default": "active"
          },
          "minRevenue": {
            "title": "Minimum revenue (EUR)",
            "minimum": 0,
            "type": "integer",
            "description": "Latest published revenue. Companies without published accounts are excluded when a revenue filter is set."
          },
          "maxRevenue": {
            "title": "Maximum revenue (EUR)",
            "minimum": 0,
            "type": "integer",
            "description": "See minimum revenue."
          },
          "isRge": {
            "title": "RGE certified",
            "type": "boolean",
            "description": "Only companies recognised as guarantors of the environment (RGE)."
          },
          "isQualiopi": {
            "title": "Qualiopi certified",
            "type": "boolean",
            "description": "Only companies with the Qualiopi quality certification."
          },
          "isBio": {
            "title": "Organic (Agence Bio)",
            "type": "boolean",
            "description": "Only companies with an establishment certified by Agence Bio."
          },
          "isEss": {
            "title": "Social and solidarity economy",
            "type": "boolean",
            "description": "Only companies of the ESS field."
          },
          "isSiae": {
            "title": "SIAE",
            "type": "boolean",
            "description": "Only structures of inclusion through economic activity."
          },
          "isTrainingOrganization": {
            "title": "Training organization",
            "type": "boolean",
            "description": "Only companies with a registered training organization."
          },
          "isAssociation": {
            "title": "Association",
            "type": "boolean",
            "description": "Only associations."
          },
          "createdAfter": {
            "title": "Created on or after",
            "type": "string",
            "description": "Date like <code>2026-01-01</code>, on the company's creation date. The source cannot filter on it, so the Actor reads the segment and skips older companies: <b>skipped companies are not charged</b>."
          },
          "excludeCommercialOptOut": {
            "title": "Skip companies opposed to commercial use",
            "type": "boolean",
            "description": "On by default. Some companies have asked that their data is not used for prospecting (opposition à la diffusion commerciale). They are skipped and not charged. Switch off only if your use is not commercial prospecting.",
            "default": true
          },
          "includeEstablishments": {
            "title": "Include establishments",
            "type": "boolean",
            "description": "Adds an <code>establishments</code> list with the establishments that match your filters (up to 100 per company). Empty when you filter on nothing but the company."
          },
          "maxItems": {
            "title": "Maximum companies",
            "minimum": 1,
            "type": "integer",
            "description": "Stops after this many companies.",
            "default": 1000
          },
          "newOnly": {
            "title": "New companies only",
            "type": "boolean",
            "description": "Monitoring mode: returns and charges only the companies that earlier runs with the same filters did not return. The first run returns everything."
          },
          "registryName": {
            "title": "Monitoring list name",
            "type": "string",
            "description": "Optional. Lowercase letters, digits and dashes. Several runs with the same filters share one list. Leave empty for the default list."
          },
          "webhookUrl": {
            "title": "Webhook URL",
            "type": "string",
            "description": "Receives a POST with a summary at the end of the run, when at least one company was returned."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}