# 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.

## Endpoint

- Method: `POST`
- URL: `https://api.helpmyagent.com/v1/company/fr/sector-statistics`
- Price: `0.020 USD` / call

## Machine discovery

- llms.txt: https://helpmyagent.com/llms.txt
- OpenAPI 3.1: https://api.helpmyagent.com/openapi.json
- capabilities.json: https://helpmyagent.com/capabilities.json
- MCP: https://helpmyagent.com/mcp
- RFC 9727: https://helpmyagent.com/.well-known/api-catalog
- pricing.json: https://helpmyagent.com/pricing.json
- x402: https://helpmyagent.com/.well-known/x402
- x402-service.json: https://helpmyagent.com/.well-known/x402-service.json
- Health status: https://helpmyagent.com/health

## x402 payment methods

- USDC on `eip155:8453`
- RLUSD on `xrpl:0`

## Coverage

FR

## Use when

- 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.

## Example queries

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

## Freshness

```json
{
    "mode": "source_dependent"
}
```

## Sources

- [API Recherche d'entreprises](https://recherche-entreprises.api.gouv.fr)

## Input schema

```json
{
    "type": "object",
    "properties": {
        "activity_code": {
            "type": "string",
            "pattern": "^[0-9]{2}\\.[0-9]{2}[A-Z]$",
            "description": "French NAF activity code to summarize, in the form 00.00A."
        },
        "department": {
            "type": "string",
            "description": "Optional French department code used to restrict results geographically."
        },
        "region": {
            "type": "string",
            "description": "Optional French region code used to restrict results geographically."
        },
        "include_financials": {
            "type": "boolean",
            "default": false,
            "description": "When true, include the supported public financial sample in the sector statistics. (default false)."
        }
    },
    "additionalProperties": false,
    "required": [
        "activity_code"
    ],
    "description": "Structured input parameters for the company/fr/sector-statistics API."
}
```

## Output schema

```json
{
    "type": "object",
    "properties": {
        "activity_code": {
            "type": "string",
            "description": "Structured value returned for “activity code” as defined by this API contract."
        },
        "department": {
            "type": [
                "string",
                "null"
            ],
            "description": "Structured value returned for “department” as defined by this API contract."
        },
        "region": {
            "type": [
                "string",
                "null"
            ],
            "description": "Structured value returned for “region” as defined by this API contract."
        },
        "total_active": {
            "type": "integer",
            "description": "Structured value returned for “total active” as defined by this API contract."
        },
        "total_active_is_exact": {
            "type": "boolean",
            "description": "Structured value returned for “total active is exact” as defined by this API contract."
        },
        "sampled_count": {
            "type": "integer",
            "description": "Structured value returned for “sampled count” as defined by this API contract."
        },
        "sample_limit": {
            "type": "integer",
            "description": "Structured value returned for “sample limit” as defined by this API contract."
        },
        "sample_coverage_percent": {
            "type": "number",
            "description": "Structured value returned for “sample coverage percent” as defined by this API contract."
        },
        "age_years": {
            "type": "object",
            "properties": {
                "min": {
                    "type": [
                        "integer",
                        "null"
                    ],
                    "description": "Structured value returned for “min” as defined by this API contract."
                },
                "median": {
                    "type": [
                        "number",
                        "integer",
                        "null"
                    ],
                    "description": "Structured value returned for “median” as defined by this API contract."
                },
                "max": {
                    "type": [
                        "integer",
                        "null"
                    ],
                    "description": "Structured value returned for “max” as defined by this API contract."
                }
            },
            "additionalProperties": false,
            "required": [
                "min",
                "median",
                "max"
            ],
            "description": "Structured value returned for “age years” as defined by this API contract."
        },
        "employee_band_distribution": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "code": {
                        "type": "string",
                        "description": "Structured value returned for “code” as defined by this API contract."
                    },
                    "count": {
                        "type": "integer",
                        "description": "Structured value returned for “count” as defined by this API contract."
                    }
                },
                "additionalProperties": false,
                "required": [
                    "code",
                    "count"
                ]
            },
            "description": "Structured value returned for “employee band distribution” as defined by this API contract."
        },
        "financial_sample_count": {
            "type": "integer",
            "description": "Structured value returned for “financial sample count” as defined by this API contract."
        },
        "median_revenue": {
            "type": [
                "number",
                "integer",
                "null"
            ],
            "description": "Structured value returned for “median revenue” as defined by this API contract."
        },
        "median_net_income": {
            "type": [
                "number",
                "integer",
                "null"
            ],
            "description": "Structured value returned for “median net income” as defined by this API contract."
        },
        "generated_at": {
            "type": "string",
            "description": "UTC timestamp at which this derived result was generated."
        },
        "limitations": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "description": "Known interpretation, source-coverage or freshness limitations for this result."
        }
    },
    "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"
    ],
    "description": "Structured result returned by the company/fr/sector-statistics API."
}
```

## Billing policy

```json
{
    "charge_on": "valid_result",
    "no_charge_on_empty_result": true,
    "no_charge_on_error": true
}
```