{
  "openapi": "3.0.1",
  "info": {
    "title": "🇫🇷 New Companies France — BODACC watch, directors & scoring",
    "description": "Detect newly registered French companies (nouvelles entreprises immatriculées au RCS) from the official BODACC. Directors, capital, legal form, address and declared activity as clean fields. INSEE enrichment without any API key, configurable lead scoring, and a watch mode for daily runs.",
    "version": "1.0",
    "x-build-id": "l514397oFaOhd58Z9"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/owoyale~nouvelles-entreprises-france/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-owoyale-nouvelles-entreprises-france",
        "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/owoyale~nouvelles-entreprises-france/runs": {
      "post": {
        "operationId": "runs-sync-owoyale-nouvelles-entreprises-france",
        "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/owoyale~nouvelles-entreprises-france/run-sync": {
      "post": {
        "operationId": "run-sync-owoyale-nouvelles-entreprises-france",
        "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": {
          "lookbackDays": {
            "title": "Profondeur de recherche (jours)",
            "minimum": 1,
            "maximum": 365,
            "type": "integer",
            "description": "Nombre de jours à remonter depuis aujourd'hui. Le BODACC publie avec 3 à 10 jours de décalage sur la date d'immatriculation : en dessous de 7 jours, vous risquez de ne rien voir. Ignoré si vous renseignez une date de début.",
            "default": 7
          },
          "dateFrom": {
            "title": "Date de début (AAAA-MM-JJ)",
            "type": "string",
            "description": "Borne basse sur la date de parution au BODACC. Laissez vide pour utiliser la profondeur de recherche."
          },
          "dateTo": {
            "title": "Date de fin (AAAA-MM-JJ)",
            "type": "string",
            "description": "Borne haute sur la date de parution. Laissez vide pour aller jusqu'à aujourd'hui."
          },
          "departements": {
            "title": "Départements ciblés",
            "type": "array",
            "description": "Codes de départements à surveiller : 75, 69, 2A, 971… Laissez vide pour couvrir toute la France. Cibler réduit fortement le volume et donc le coût.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "maxResults": {
            "title": "Nombre maximum de résultats",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Plafond de leads livrés — et donc facturés — pour cette exécution.",
            "default": 200
          },
          "enrich": {
            "title": "Enrichir depuis le référentiel INSEE",
            "type": "boolean",
            "description": "Ajoute le code NAF, la tranche d'effectif, l'état administratif, le SIRET du siège, les coordonnées géographiques et, si disponibles, les éléments financiers. Aucune clé d'API n'est requise. Les créations très récentes ne sont pas encore indexées : le lead BODACC est alors livré seul.",
            "default": true
          },
          "dryRun": {
            "title": "Estimer sans livrer (gratuit)",
            "type": "boolean",
            "description": "Compte les créations correspondant à vos critères et s'arrête. Aucune donnée livrée, aucune facturation. À utiliser pour calibrer votre fenêtre avant une exécution réelle.",
            "default": false
          },
          "watchMode": {
            "title": "Mode veille — ne renvoyer que les nouveautés",
            "type": "boolean",
            "description": "Mémorise ce qui a déjà été livré. Aux exécutions suivantes, seules les créations jamais vues sont renvoyées et facturées. C'est le mode à utiliser avec une planification quotidienne.",
            "default": false
          },
          "watchId": {
            "title": "Identifiant de veille",
            "type": "string",
            "description": "Permet de mener plusieurs veilles indépendantes avec le même Actor — par exemple « paris-sas » et « lyon-commerce ». Chaque identifiant a sa propre mémoire.",
            "default": "defaut"
          },
          "minScore": {
            "title": "Score minimum (0 à 100)",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Les créations en dessous de ce score ne sont ni livrées ni facturées. 0 pour tout recevoir, 55 pour ne garder que les cibles sérieuses.",
            "default": 0
          },
          "targetDepartements": {
            "title": "Départements prioritaires (scoring)",
            "type": "array",
            "description": "Départements qui font monter le score, sans exclure les autres. Différent du filtre « Départements ciblés », qui lui exclut.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "targetFormesJuridiques": {
            "title": "Formes juridiques recherchées",
            "type": "array",
            "description": "Fragments de libellé recherchés, par exemple « société par actions » ou « responsabilité limitée ». Une correspondance porte le score de forme à 100, une absence le ramène à 15.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "targetCapitalMin": {
            "title": "Capital social minimum (€)",
            "minimum": 0,
            "type": "integer",
            "description": "En dessous, le score de capital tombe à zéro. Laissez vide pour appliquer le barème par paliers."
          },
          "targetCapitalMax": {
            "title": "Capital social maximum (€)",
            "minimum": 0,
            "type": "integer",
            "description": "Au-dessus, le score de capital est réduit — utile pour écarter les grands groupes si vous ciblez les TPE."
          },
          "excludeSCI": {
            "title": "Exclure les sociétés civiles immobilières",
            "type": "boolean",
            "description": "Les SCI représentent une part notable des immatriculations et sont hors cible pour la plupart des offres B2B. Cochez pour les ramener à un score de zéro.",
            "default": false
          },
          "excludePreexistantes": {
            "title": "Exclure les activités préexistantes",
            "type": "boolean",
            "description": "Certaines immatriculations ne sont pas des créations : un micro-entrepreneur en activité depuis des années bascule au registre du commerce. Mesuré sur un lot réel : 8 sur 20. Cochez pour ramener leur score à zéro — elles ne sont plus en phase d'équipement.",
            "default": false
          },
          "fraicheurIdealeJours": {
            "title": "Fenêtre de fraîcheur idéale (jours)",
            "minimum": 1,
            "maximum": 180,
            "type": "integer",
            "description": "En deçà de ce nombre de jours depuis l'immatriculation, le score de fraîcheur est maximal. Au-delà, il décroît jusqu'à zéro à 180 jours.",
            "default": 30
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}