{
  "openapi": "3.0.1",
  "info": {
    "title": "France New Company Finder (BODACC + SIRENE, by NAF & Dept)",
    "description": "Daily feed of newly registered French companies (legal entities only) from official BODACC creations, enriched with SIRENE: SIREN/SIRET, NAF, legal form, head office with GPS, employee range, capital, VAT number. Filter by date, NAF, département, region, legal form.",
    "version": "0.1",
    "x-build-id": "QRViuniwFrE0r4fwA"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/lindenbyte~france-new-companies/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-lindenbyte-france-new-companies",
        "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/lindenbyte~france-new-companies/runs": {
      "post": {
        "operationId": "runs-sync-lindenbyte-france-new-companies",
        "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/lindenbyte~france-new-companies/run-sync": {
      "post": {
        "operationId": "run-sync-lindenbyte-france-new-companies",
        "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": {
          "publishedLastDays": {
            "title": "Published in the last N days",
            "minimum": 1,
            "maximum": 3660,
            "type": "integer",
            "description": "Rolling window on the BODACC publication date (French time): 1 = today only, 3 = the last 3 days including today. Overrides the from/to dates. If everything is empty the last 7 days are used. BODACC publishes Monday to Saturday, usually a few days after the registration; for a daily schedule use 3 and dedupe on 'siren' downstream."
          },
          "publishedFrom": {
            "title": "Published from (YYYY-MM-DD)",
            "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}$",
            "type": "string",
            "description": "First BODACC publication date, inclusive, e.g. 2026-11-01. Used only when 'last N days' is empty."
          },
          "publishedTo": {
            "title": "Published to (YYYY-MM-DD)",
            "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}$",
            "type": "string",
            "description": "Last BODACC publication date, inclusive. Empty = today."
          },
          "departements": {
            "title": "Départements",
            "type": "array",
            "description": "Département codes or names, e.g. 75, 69, 13, 2A, 971 or 'Gironde'. A company matches when its head office (siège) is in one of them. Empty = all of France (incl. overseas).",
            "items": {
              "type": "string"
            }
          },
          "regions": {
            "title": "Regions",
            "type": "array",
            "description": "Adds every département of these regions (INSEE region codes). Combined with 'Départements' as an OR.",
            "items": {
              "type": "string",
              "enum": [
                "01",
                "02",
                "03",
                "04",
                "06",
                "11",
                "24",
                "27",
                "28",
                "32",
                "44",
                "52",
                "53",
                "75",
                "76",
                "84",
                "93",
                "94",
                "975"
              ],
              "enumTitles": [
                "Guadeloupe",
                "Martinique",
                "Guyane",
                "La Réunion",
                "Mayotte",
                "Île-de-France",
                "Centre-Val de Loire",
                "Bourgogne-Franche-Comté",
                "Normandie",
                "Hauts-de-France",
                "Grand Est",
                "Pays de la Loire",
                "Bretagne",
                "Nouvelle-Aquitaine",
                "Occitanie",
                "Auvergne-Rhône-Alpes",
                "Provence-Alpes-Côte d'Azur",
                "Corse",
                "Saint-Pierre-et-Miquelon"
              ]
            }
          },
          "nafCodes": {
            "title": "NAF / APE codes",
            "type": "array",
            "description": "Activity codes (NAF rév. 2, also matched against NAF 2025): exact (62.01Z), prefix (62.01, 62) or section letter (J = information & communication, F = construction, I = hospitality). Needs the SIRENE enrichment; companies not yet in SIRENE are dropped (free) when this is set.",
            "items": {
              "type": "string"
            }
          },
          "legalForms": {
            "title": "Legal form groups",
            "type": "array",
            "description": "Keep only these legal form families (e.g. SAS for SAS/SASU, SARL for SARL/EURL, SCI). Empty = all legal entities. Sole traders (entrepreneurs individuels) are never returned.",
            "items": {
              "type": "string",
              "enum": [
                "SAS",
                "SARL",
                "SA",
                "SNC",
                "SCI",
                "SC",
                "AGRI",
                "SEL",
                "COOP",
                "GIE",
                "FOREIGN",
                "OTHER"
              ],
              "enumTitles": [
                "SAS / SASU (société par actions simplifiée)",
                "SARL / EURL (société à responsabilité limitée)",
                "SA (société anonyme)",
                "SNC (société en nom collectif)",
                "SCI (société civile immobilière, incl. construction-vente)",
                "Other société civile (SC, SCM, SCP, holding SC...)",
                "Agricultural (EARL, GAEC, SCEA, GFA, coopérative agricole)",
                "Liberal professions (SELARL, SELAS, SELAFA, SPFPL)",
                "Cooperative (SCOP, SCIC and other coopératives)",
                "GIE / GEIE",
                "Foreign company registered in France",
                "Other legal entity"
              ]
            }
          },
          "legalFormCodes": {
            "title": "INSEE legal form codes (advanced)",
            "type": "array",
            "description": "INSEE 'catégorie juridique' codes or prefixes, e.g. 5710 (SAS), 5499 (SARL), 6540 (SCI), 57 (all SAS). Needs the SIRENE enrichment.",
            "items": {
              "type": "string"
            }
          },
          "activityKeywords": {
            "title": "Activity keywords",
            "type": "array",
            "description": "Words searched in the activity description of the BODACC notice (French), e.g. 'restaurant', 'logiciel', 'boulangerie'. A company matches if any keyword appears. Applied by the API, so it is fast.",
            "items": {
              "type": "string"
            }
          },
          "excludeCommercialOptOut": {
            "title": "Exclude companies opted out of commercial prospecting",
            "type": "boolean",
            "description": "Drop companies whose SIRENE record carries an objection to commercial use (opposition_diffusion_commerciale). Recommended for cold outreach in France. Note: most brand-new companies carry this flag, so expect far fewer results. Dropped rows are free.",
            "default": false
          },
          "onlyWithSireneData": {
            "title": "Only companies already in SIRENE",
            "type": "boolean",
            "description": "Drop companies that are in BODACC but not yet indexed in SIRENE (about 10% of the newest notices; they appear within days). Dropped rows are free.",
            "default": false
          },
          "enrichWithSirene": {
            "title": "Enrich with SIRENE",
            "type": "boolean",
            "description": "Look each company up in the official recherche-entreprises API (SIRET, NAF, legal form code, head-office address with GPS, employee range, category). Off = BODACC fields only (much faster; NAF/legal-form-code/opt-out filters need it on).",
            "default": true
          },
          "maxResults": {
            "title": "Max companies",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "Stop after this many companies have been saved.",
            "default": 1000
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}