Recherche Entreprises Scraper

Extract and enrich French company data from the official recherche-entreprises.api.gouv.fr API. Search using filters like activity code, revenue, location, and date, then automatically augment results with detailed legal, financial, and director information.

Overview

This actor queries the French government's company search API. It handles search parameters, pagination, and rate limits, then enriches the base results with additional data from annuaire-entreprises.data.gouv.fr. It's useful for lead generation, market analysis, or building datasets of French businesses.

Key Features

• Search & Filter: Find companies by name, location (coordinates/radius), activity code (NAF/APE), revenue, creation date, postal code, and administrative status.
• Automatic Enrichment: Fetches supplemental data for each company, including:
  • Legal details (SIRET siège, VAT number, legal form).
  • Employee counts and company size classification (PME/ETI/GE).
  • Up to 5 directors (Presidents, Directors, Managers).
  • Registration dates and additional address info.
• Performance: Uses parallel processing (50 concurrent requests) for faster enrichment and manages API rate limits.
• Data Handling: Automatically paginates through all result pages (up to 1000) and can filter results by creation date post-query.
• Export: Outputs data to a structured dataset. For local testing, it can also generate a CSV file.

How to Use

Configure the actor via input settings, then run it. It will execute the search, perform enrichment, and store the results in the dataset.

Input Configuration

The main input is the search_params object, which maps directly to the official API's query parameters. Common options include:

• q: Text search (name, address, director name).
• code_postal: Postal code.
• departement: Department code.
• activite_principale: Activity code (NAF/APE).
• chiffre_affaires_min / chiffre_affaires_max: Revenue range.
• date_creation_min / date_creation_max: Company creation date range.
• latitude, longitude, radius: Geographic search around coordinates (meters).

Example Input:

{
  "search_params": {
    "code_postal": "75008",
    "activite_principale": "62.01Z"
  },
  "enrich_data": true,
  "max_pages": 10
}

Key Settings:
* enrich_data: Set to false to skip the enrichment step and get only basic API results.
* max_pages: Limit the number of result pages to process (1 page ≈ 20 results).
* post_filter_date_min: Filter the final results to companies created after this date (YYYY-MM-DD).

Input/Output

Input: A JSON object defining search_params and operational limits (like max_pages).

Output: The actor stores items in the dataset. Each item is a company record. With enrichment enabled, the output includes all basic API fields plus the enriched details.

Example Output Item (abbreviated):

{
  "siren": "123456789",
  "nom_complet": "EXAMPLE SARL",
  "code_postal": "75008",
  "ville": "PARIS",
  "activite_principale": "62.01Z",
  "date_creation": "2015-06-01",
  "etat_administratif": "A",
  "enriched_data": {
    "siret_siege": "12345678900001",
    "tva_intracommunautaire": "FR12345678901",
    "forme_juridique": "SARL",
    "effectif_salarie": "12",
    "date_immatriculation_rne": "2015-06-05",
    "dirigeants": [
      { "nom": "DUPONT", "prenom": "Jean", "role": "Président" }
    ]
  }
}

Results can be accessed via the Apify API, downloaded as JSON, CSV, Excel, etc., or integrated with tools like Make.com, Zapier, or Google Sheets. You can also schedule the actor for regular runs.