helpmyagent.com
FR Connect my AI
☰

French Company Sector Statistics

Returns the source-reported active-company count for a French NAF activity plus explicit descriptive samples for age, workforce bands and optional financials; large counts can be capped at 10,000 by the source.

0.020 USD

Charged on valid result · Empty result not charged · Errors not charged

When to use this API?

Use for

  • Measure the source-reported active-company count for a French NAF activity and obtain descriptive sample statistics.

Avoid when

  • You need an official INSEE statistical publication rather than statistics computed from company records.

Limitations

  • The Recherche d'entreprises search engine caps large total-result counts at 10,000. When total_active is 10000, total_active_is_exact is false and the true count is at least 10,000.
  • Age, workforce-band and financial distributions remain explicitly sampled. When the total count is capped, sample_coverage_percent is an upper bound.

Sources and provenance

API Recherche d'entreprises

recherche-entreprises.api.gouv.fr

Input / Output schemas

Simplified endpoint contracts. The complete schema remains available in OpenAPI 3.1.

OpenAPI 3.1 →

Input schema
activity_codestring

Required

departmentstring

regionstring

include_financialsboolean

View full JSON Schema
{
    "type": "object",
    "properties": {
        "activity_code": {
            "type": "string",
            "pattern": "^[0-9]{2}\\.[0-9]{2}[A-Z]$"
        },
        "department": {
            "type": "string"
        },
        "region": {
            "type": "string"
        },
        "include_financials": {
            "type": "boolean",
            "default": false
        }
    },
    "additionalProperties": false,
    "required": [
        "activity_code"
    ]
}
Output schema
activity_codestring

Required

departmentstring | null

Required

regionstring | null

Required

total_activeinteger

Required

total_active_is_exactboolean

Required

sampled_countinteger

Required

sample_limitinteger

Required

sample_coverage_percentnumber

Required

age_yearsobject

Required

employee_band_distributionarray

Required

financial_sample_countinteger

Required

median_revenuenumber | integer | null

Required

median_net_incomenumber | integer | null

Required

generated_atstring

Required

limitationsarray

View full JSON Schema
{
    "type": "object",
    "properties": {
        "activity_code": {
            "type": "string"
        },
        "department": {
            "type": [
                "string",
                "null"
            ]
        },
        "region": {
            "type": [
                "string",
                "null"
            ]
        },
        "total_active": {
            "type": "integer"
        },
        "total_active_is_exact": {
            "type": "boolean"
        },
        "sampled_count": {
            "type": "integer"
        },
        "sample_limit": {
            "type": "integer"
        },
        "sample_coverage_percent": {
            "type": "number"
        },
        "age_years": {
            "type": "object",
            "properties": {
                "min": {
                    "type": [
                        "integer",
                        "null"
                    ]
                },
                "median": {
                    "type": [
                        "number",
                        "integer",
                        "null"
                    ]
                },
                "max": {
                    "type": [
                        "integer",
                        "null"
                    ]
                }
            },
            "additionalProperties": false,
            "required": [
                "min",
                "median",
                "max"
            ]
        },
        "employee_band_distribution": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "code": {
                        "type": "string"
                    },
                    "count": {
                        "type": "integer"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "code",
                    "count"
                ]
            }
        },
        "financial_sample_count": {
            "type": "integer"
        },
        "median_revenue": {
            "type": [
                "number",
                "integer",
                "null"
            ]
        },
        "median_net_income": {
            "type": [
                "number",
                "integer",
                "null"
            ]
        },
        "generated_at": {
            "type": "string"
        },
        "limitations": {
            "type": "array",
            "items": {
                "type": "string"
            }
        }
    },
    "additionalProperties": false,
    "required": [
        "activity_code",
        "department",
        "region",
        "total_active",
        "total_active_is_exact",
        "sampled_count",
        "sample_limit",
        "sample_coverage_percent",
        "age_years",
        "employee_band_distribution",
        "financial_sample_count",
        "median_revenue",
        "median_net_income",
        "generated_at"
    ]
}

Example queries

How many active companies are reported for NAF 62.01Z and what does the sample look like?