# France Entreprises Scraper (`ahmed_hrid/france-entreprises-scraper`) Actor

Extrayez des données officielles d'entreprises françaises : SIREN/SIRET, effectifs, NAF, dirigeants. API gouvernementale INSEE/INPI. Pour prospection B2B, conformité et étude de marché.

- **URL**: https://apify.com/ahmed\_hrid/france-entreprises-scraper.md
- **Developed by:** [Ahmed hrid](https://apify.com/ahmed_hrid) (community)
- **Categories:** Automation, Integrations, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 business extracteds

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Extracteur d'Entreprises Françaises

Extrayez des données officielles d'entreprises françaises depuis l'API gouvernementale incluant les numéros SIREN/SIRET, informations légales, effectifs, codes NAF, adresses de sièges sociaux et dirigeants. Parfait pour la prospection B2B, la vérification de conformité et l'étude de marché en France.

### Qu'est-ce que l'Extracteur d'Entreprises Françaises ?

L'Extracteur d'Entreprises Françaises est un outil puissant qui extrait des données officielles d'entreprises depuis l'API publique du gouvernement français. Accédez à des informations commerciales vérifiées incluant le statut juridique, les numéros d'immatriculation, les tranches d'effectifs, les codes d'activité et les listes de dirigeants. Toutes les données proviennent directement des sources officielles françaises (INSEE, INPI). Idéal pour **les équipes conformité, les commerciaux B2B, la due diligence, les analystes de marché et les développeurs commerciaux** opérant en France.

**Avantages clés de cet Actor sur Apify :**
- ⏰ **Planification** - Mises à jour automatiques quotidiennes ou hebdomadaires
- 🔄 **Accès API** - Intégrez les données d'entreprises françaises dans vos systèmes
- 🌐 **Proxies résidentiels français** - Accès fiable à l'API gouvernementale
- 📊 **Formats d'export multiples** - JSON, CSV, Excel, XML
- 🔗 **Intégrations** - Connexion avec Zapier, Make, webhooks
- 📈 **Surveillance** - Suivez les changements de statut d'entreprises
- 🏛️ **Données officielles** - Directement depuis les sources gouvernementales
- ✅ **Informations vérifiées** - Données légales, réglementaires et financières

### Que peut faire l'Extracteur d'Entreprises Françaises ?

Cet Actor fournit des fonctionnalités puissantes pour extraire des données officielles d'entreprises françaises :

✅ **Accès API gouvernementale** - Accès direct au registre officiel des entreprises françaises
✅ **Recherche SIREN/SIRET** - Recherche par numéros d'immatriculation
✅ **Recherche d'entreprises** - Trouvez des sociétés par nom, code NAF, localisation
✅ **Informations légales** - Statut, forme juridique, dates de création/fermeture
✅ **Données d'effectifs** - Tranches d'effectifs et nombre d'établissements
✅ **Codes d'activité** - Codes NAF/APE et secteurs d'activité
✅ **Infos siège social** - Adresse complète et coordonnées GPS
✅ **Liste des dirigeants** - Dirigeants et représentants légaux
✅ **Indicateurs de certification** - Qualiopi, Bio, Entrepreneur Vert, etc.
✅ **Extraction en masse** - Jusqu'à 10 000 entreprises par exécution
✅ **Données en temps réel** - Informations fraîches depuis les sources gouvernementales

### Quelles données l'Extracteur peut-il extraire ?

| Champ | Description | Exemple |
|-------|-------------|---------|
| **SIREN** | Identifiant d'entreprise à 9 chiffres | "123456789" |
| **SIRET** | Identifiant d'établissement à 14 chiffres | "12345678901234" |
| **Nom de l'entreprise** | Raison sociale complète | "TechCorp Solutions" |
| **Dénomination légale** | Nom légal officiel | "TechCorp Solutions SAS" |
| **Sigle** | Acronyme de l'entreprise | "TCS" |
| **Nom commercial** | Enseigne commerciale | "TechCorp" |
| **Statut** | Actif ou fermé | "active", "closed" |
| **Date de création** | Date d'immatriculation | "2015-03-15" |
| **Date de fermeture** | Date de cessation si applicable | "2023-12-31" ou null |
| **Code forme juridique** | Code NAF structure légale | "5710" (SAS) |
| **Catégorie** | Taille d'entreprise | "PME", "ETI", "GE" |
| **Code activité** | Code NAF/APE principal | "6201Z" |
| **Section d'activité** | Secteur d'activité | "Information et communication" |
| **Est employeur** | Possède des salariés | true/false |
| **Tranche d'effectifs** | Nombre de salariés | "10-19" |
| **Total établissements** | Nombre de sites | 5 |
| **Établissements actifs** | Sites ouverts | 4 |
| **Siège social** | Adresse siège & GPS | Objet complet |
| **Dirigeants** | Liste des dirigeants | Tableau de dirigeants |
| **Est association** | Statut associatif | true/false |
| **Est entrepreneur individuel** | Entreprise individuelle | true/false |
| **Est service public** | Entité gouvernementale | true/false |
| **Est économie sociale** | Statut ESS | true/false |
| **Est organisme de formation** | Prestataire de formation | true/false |
| **Possède Qualiopi** | Certification qualité | true/false |
| **Est Bio** | Certification bio | true/false |
| **Est Entrepreneur Vert** | Statut éco-responsable | true/false |
| **Possède Société à Mission** | Entreprise à mission | true/false |
| **Possède Index Égalité F/H** | Index publié | true/false |
| **Possède convention collective** | Accord de branche | true/false |

### Comment extraire des données d'entreprises françaises

Utiliser l'Extracteur d'Entreprises Françaises est simple :

1. **Ouvrez l'Extracteur** dans la Console Apify
2. **Entrez votre requête** - Nom d'entreprise, SIREN, SIRET ou code NAF
3. **Définissez le nombre max** - Jusqu'à 10 000 entreprises (par défaut : 100)
4. **Cliquez sur Démarrer** et attendez les résultats
5. **Téléchargez vos données** en JSON, CSV ou Excel

**Exemples de requêtes :**
- Nom d'entreprise : "LVMH", "Carrefour", "Total"
- Numéro SIREN : "552100554"
- Code NAF : "6201Z" (programmation informatique)


**Intégrez avec des webhooks**

Automatisez votre surveillance d'entreprises françaises en configurant des webhooks qui se déclenchent à la fin de l'extraction. Envoyez les données vérifiées vers votre CRM, systèmes de conformité ou outils de business intelligence. Parfait pour les workflows de due diligence et la surveillance de marché.

### Combien coûte l'extraction d'entreprises françaises ?

L'Extracteur d'Entreprises Françaises utilise une tarification transparente au résultat :

**💰 3$ pour 1 000 entreprises**

**Ce que vous obtenez :**
- ✅ Payez uniquement pour les entreprises extraites avec succès
- ✅ Pas d'abonnement mensuel
- ✅ Tous les champs de données inclus (30+ champs par entreprise)
- ✅ Sources de données gouvernementales officielles
- ✅ Accès API complet et webhooks
- ✅ Planification et surveillance
- ✅ Tous les formats d'export (JSON, CSV, Excel, XML)
- ✅ Proxies résidentiels français inclus

**Exemples de coûts :**
- 100 entreprises = 0,30$
- 500 entreprises = 1,50$
- 1 000 entreprises = 3,00$
- 5 000 entreprises = 15,00$
- 10 000 entreprises = 30,00$

**Parfait pour :**
- 🎯 Équipes commerciales B2B construisant des listes de prospects français
- 📊 Équipes de due diligence vérifiant les informations d'entreprises
- 🏢 Responsables conformité vérifiant le statut réglementaire
- 💼 Développeurs commerciaux étudiant les marchés français
- 📈 Analystes de marché étudiant les secteurs d'activité
- 🌍 Entreprises internationales s'implantant en France

Avec l'offre gratuite d'Apify (5$/mois de crédit), vous pouvez extraire jusqu'à 1 600 entreprises françaises gratuitement chaque mois !

### Paramètres d'entrée

L'Extracteur d'Entreprises Françaises accepte les paramètres suivants. Cliquez sur l'onglet **Input** pour la configuration.

**Champ obligatoire :**
- **Requête de recherche** - Nom d'entreprise, SIREN, SIRET

**Champs optionnels :**
- **Résultats maximum** - Limiter les résultats (1-10 000 entreprises, défaut : 100)
- **Configuration proxy** - Proxies résidentiels français (recommandé)

**Conseils pour les requêtes :**
- Utilisez les noms complets d'entreprises pour de meilleurs résultats
- SIREN (9 chiffres) pour une recherche exacte d'entreprise
- SIRET (14 chiffres) pour un établissement spécifique
- Codes NAF (ex : "6201Z") pour les recherches par secteur

### Données de sortie

L'Extracteur d'Entreprises Françaises retourne des données structurées téléchargeables en JSON, CSV, Excel ou XML.

**Exemple de sortie :**

```json
{
  "siren": "987654321",
  "siret": "98765432100015",
  "name": "TechCorp Solutions",
  "legalName": "TechCorp Solutions SAS",
  "acronym": "TCS",
  "commercialName": "TechCorp",
  "status": "active",
  "createdAt": "2015-03-15",
  "closedAt": null,
  "legalFormCode": "5710",
  "category": "PME",
  "activityCode": "6201Z",
  "activitySection": "Information et communication",
  "isEmployer": true,
  "employeeRange": "10 à 19 salariés",
  "totalEstablishments": 3,
  "activeEstablishments": 3,
  "headquarters": {
    "address": "15 Avenue des Champs-Élysées",
    "postalCode": "75008",
    "city": "Paris",
    "lat": 48.8698,
    "lng": 2.3074
  },
  "directors": [
    {
      "name": "Jean Dupont",
      "role": "Président"
    }
  ],
  "isAssociation": false,
  "isSoleTrader": false,
  "isPublicService": false,
  "isSocialEconomy": false,
  "isTrainingOrg": false,
  "hasQualiopi": false,
  "isBio": false,
  "isGreenContractor": true,
  "hasSocieteM": false,
  "hasGenderEqualityIndex": true,
  "hasCollectiveAgreement": true
}
````

Le dataset est propre, structuré et prêt pour l'import dans les CRM, systèmes de conformité ou outils de business intelligence.

### Cas d'usage pour les données d'entreprises françaises

#### Ventes B2B & Génération de Leads

- **Qualification de prospects** - Vérifier la taille, le statut et l'activité de l'entreprise
- **Planification territoriale** - Cartographier les entreprises par secteur et localisation
- **Enrichissement de leads** - Ajouter des données officielles aux contacts existants
- **Recherche de décideurs** - Identifier les dirigeants et cadres

#### Conformité & Due Diligence

- **Vérification KYC** - Vérifier le statut légal et l'immatriculation
- **Contrôle fournisseurs** - Valider les informations des vendeurs
- **Vérification contractuelle** - Confirmer les détails de l'entité légale
- **Conformité réglementaire** - Vérifier les certifications et statuts

#### Étude de Marché

- **Analyse sectorielle** - Compter les entreprises par code NAF et région
- **Intelligence concurrentielle** - Suivre les changements légaux des concurrents
- **Dimensionnement du marché** - Calculer le marché adressable total
- **Identification de tendances** - Surveiller les taux de création/fermeture

#### Développement Commercial

- **Sourcing de partenaires** - Trouver des entreprises avec des certifications spécifiques
- **Recherche de franchise** - Analyser les entreprises multi-établissements
- **Screening d'investissement** - Rechercher des cibles d'acquisition potentielles
- **Analyse de localisation** - Identifier les zones à forte densité d'entreprises

#### Enrichissement de Données

- **Mises à jour CRM** - Maintenir les dossiers d'entreprises à jour
- **Construction de base de données** - Créer des annuaires d'entreprises complets
- **Intégration API** - Alimenter les données dans les systèmes internes
- **Gestion des données de référence** - Maintenir les enregistrements de référence

### Conseils pour de meilleurs résultats

**Optimisez vos recherches :**

- 🎯 Utilisez des noms d'entreprises spécifiques pour des résultats précis
- 📍 Commencez avec SIREN/SIRET pour des correspondances exactes
- 🔄 Utilisez les codes NAF pour trouver des entreprises dans des secteurs spécifiques

**Maximisez la qualité des données :**

- ✅ Vérifiez que les numéros SIREN ont 9 chiffres
- ✅ Les numéros SIRET doivent avoir 14 chiffres
- ✅ Utilisez les noms officiels d'entreprises françaises
- ✅ Vérifiez le champ statut pour les entreprises actives uniquement
- ✅ Les tranches d'effectifs indiquent la taille de l'entreprise

**Économisez sur les coûts :**

- Commencez avec 100 résultats pour tester les requêtes
- Affinez les recherches avant les grandes extractions
- Utilisez des critères spécifiques pour réduire les résultats non pertinents
- Planifiez des petites mises à jour régulières vs de grandes extractions occasionnelles

**Idées d'intégration :**

- Importer dans Salesforce ou HubSpot CRM
- Enrichir les bases de données existantes avec des données officielles
- Construire des annuaires d'entreprises françaises
- Créer des tableaux de bord de surveillance de conformité
- Alimenter les workflows de due diligence
- Intégrer avec les systèmes comptables

**Comprendre les codes d'entreprises françaises :**

- **SIREN** : Identifiant unique d'entreprise à 9 chiffres (ne change jamais)
- **SIRET** : Identifiant d'établissement à 14 chiffres (SIREN + 5 chiffres)
- **NAF/APE** : Code d'activité (ex : 6201Z = programmation)
- **Codes forme juridique** : 5710 = SAS, 5499 = SA, etc.
- **Catégories** : PME (petite), ETI (moyenne), GE (grande)

### Dépannage

**Aucun résultat trouvé ?**

- ✅ Vérifiez l'orthographe du nom de l'entreprise
- ✅ Essayez de rechercher par SIREN plutôt que par nom
- ✅ Vérifiez que l'entreprise est immatriculée en France
- ✅ Certaines entreprises très récentes peuvent ne pas être indexées

**Moins de résultats que prévu ?**

- Augmentez la limite maxResults (défaut : 100)
- Affinez la requête de recherche pour une meilleure correspondance
- Vérifiez si vous recherchez des entreprises fermées
- Certaines requêtes peuvent avoir des correspondances limitées dans la base

**Champs de données manquants ?**

- Toutes les entreprises n'ont pas toutes les certifications
- La liste des dirigeants peut être vide pour certaines structures
- Les entreprises fermées ont des informations limitées
- Les très petites entreprises peuvent avoir des données minimales

**SIREN/SIRET ne fonctionne pas ?**

- Assurez-vous d'avoir 9 chiffres pour SIREN (sans espaces)
- Assurez-vous d'avoir 14 chiffres pour SIRET
- Certains très vieux SIREN peuvent être inactifs
- Vérifiez que le numéro n'a pas été réattribué

**Comprendre les valeurs de statut :**

- "active" = Actuellement en activité
- "closed" = Plus en activité
- Vérifiez la date closedAt pour le timing de fermeture

**Interprétation des tranches d'effectifs :**

- "0" = Pas de salariés (peut être entrepreneur individuel)
- "1-2" = Micro-entreprise
- "10-19" = Petite entreprise
- "250-499" = Entreprise moyenne
- "10000+" = Grande entreprise

**Besoin d'aide ?**

- 💬 Utilisez l'onglet **Issues** pour signaler des bugs
- 📧 [Contactez le développeur pour des solutions personnalisées](me@ahmedhrid.com)
- 🎓 Consultez l'[Apify Academy](https://docs.apify.com/academy)
- 👥 Rejoignez le [Discord Apify](https://discord.com/invite/jyEM2PRvMU)

### Accès API et intégrations

L'Extracteur d'Entreprises Françaises fournit un accès API complet :

#### API REST

```bash
curl -X POST https://api.apify.com/v2/acts/YOUR_ACTOR_ID/runs \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Paris tech",
    "maxResults": 500
  }'
```

#### JavaScript/Node.js

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });
const input = {
  query: "6201Z", // Code NAF programmation informatique
  maxResults: 1000
};

const run = await client.actor("YOUR_ACTOR_ID").call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();

// Filtrer les entreprises actives avec salariés
const activeEmployers = items.filter(c => 
  c.status === 'active' && c.isEmployer
);
console.log(`Trouvé ${activeEmployers.length} employeurs actifs`);
```

#### Python

```python
from apify_client import ApifyClient

client = ApifyClient('YOUR_API_TOKEN')
run_input = {
    "query": "LVMH",
    "maxResults": 100
}

run = client.actor("YOUR_ACTOR_ID").call(run_input=run_input)
items = client.dataset(run["defaultDatasetId"]).list_items().items

## Analyser par taille d'entreprise
categories = {}
for item in items:
    cat = item.get('category', 'Inconnu')
    categories[cat] = categories.get(cat, 0) + 1
    
print("Entreprises par catégorie:", categories)
```

### Questions Fréquemment Posées

#### Quelle est la différence entre SIREN et SIRET ?

Le SIREN (9 chiffres) identifie l'entreprise. Le SIRET (14 chiffres) identifie chaque établissement. Un SIREN peut avoir plusieurs SIRET.

#### Ces données sont-elles mises à jour en temps réel ?

Oui, les données proviennent directement de l'API gouvernementale avec les dernières informations officielles.

#### Puis-je rechercher par secteur d'activité ?

Oui, utilisez les codes NAF/APE (ex : "6201Z" pour programmation, "5610A" pour restaurants).

#### Les entreprises fermées sont-elles incluses ?

Oui, sauf si vous filtrez par `status: "active"` dans vos résultats. Les entreprises fermées ont une date closedAt.

#### Puis-je obtenir des données financières ?

Non, cette API fournit uniquement des données légales/administratives. Les états financiers nécessitent d'autres sources.

#### Que sont les catégories d'entreprises (PME, ETI, GE) ?

- PME : Petite/moyenne entreprise (<250 salariés)
- ETI : Entreprise de taille intermédiaire (250-5000 salariés)
- GE : Grande entreprise (5000+ salariés)

#### Puis-je exporter vers mon CRM ?

Oui, utilisez l'export CSV/Excel ou intégrez via API avec Zapier/Make vers Salesforce, HubSpot, etc.

#### Quelle est la précision des données d'effectifs ?

Les tranches d'effectifs sont des déclarations officielles INSEE, mises à jour régulièrement mais peuvent avoir un décalage de quelques mois.

#### Puis-je rechercher plusieurs SIREN à la fois ?

Actuellement une requête par exécution. Utilisez l'API pour automatiser plusieurs recherches séquentiellement.

#### Qu'est-ce que la certification Qualiopi ?

Certification qualité française pour les organismes de formation (validée par l'État).

#### Les noms des dirigeants sont-ils inclus ?

Oui, les noms et rôles des dirigeants sont extraits quand disponibles (information publique).

***

**Construit pour l'intelligence économique et la conformité françaises 🇫🇷**

Questions ? Suggestions ? Utilisez l'onglet **Issues** ou laissez un avis !

**Essayez l'Extracteur d'Entreprises Françaises aujourd'hui** et accédez aux données officielles d'entreprises du gouvernement français.

**Développeur :** Ahmed Hrid - me@ahmedhrid.com

# Actor input Schema

## `query` (type: `string`):

Search query to find French companies (name, SIREN, NAF code, etc.).

## `maxResults` (type: `integer`):

Maximum number of companies to scrape.

## `proxyConfiguration` (type: `object`):

Apify proxy settings. Defaults to French residential proxies.

## Actor input object example

```json
{
  "query": "LVMH",
  "maxResults": 100,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "FR"
  }
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "query": "LVMH"
};

// Run the Actor and wait for it to finish
const run = await client.actor("ahmed_hrid/france-entreprises-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "query": "LVMH" }

# Run the Actor and wait for it to finish
run = client.actor("ahmed_hrid/france-entreprises-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "query": "LVMH"
}' |
apify call ahmed_hrid/france-entreprises-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=ahmed_hrid/france-entreprises-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "France Entreprises Scraper",
        "description": "Extrayez des données officielles d'entreprises françaises : SIREN/SIRET, effectifs, NAF, dirigeants. API gouvernementale INSEE/INPI. Pour prospection B2B, conformité et étude de marché.",
        "version": "0.0",
        "x-build-id": "Vh7JTb7fZtsD2S4Ee"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/ahmed_hrid~france-entreprises-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-ahmed_hrid-france-entreprises-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/ahmed_hrid~france-entreprises-scraper/runs": {
            "post": {
                "operationId": "runs-sync-ahmed_hrid-france-entreprises-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/ahmed_hrid~france-entreprises-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-ahmed_hrid-france-entreprises-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",
                "required": [
                    "query"
                ],
                "properties": {
                    "query": {
                        "title": "Search query",
                        "type": "string",
                        "description": "Search query to find French companies (name, SIREN, NAF code, etc.)."
                    },
                    "maxResults": {
                        "title": "Max results",
                        "minimum": 1,
                        "maximum": 10000,
                        "type": "integer",
                        "description": "Maximum number of companies to scrape.",
                        "default": 100
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Apify proxy settings. Defaults to French residential proxies.",
                        "default": {
                            "useApifyProxy": true,
                            "apifyProxyGroups": [
                                "RESIDENTIAL"
                            ],
                            "apifyProxyCountry": "FR"
                        }
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
