# Benchmark a French company against public peers

Benchmarks a company against public peers using available revenue, net income, growth and margin metrics.

## Endpoint

- Method: `POST`
- URL: `https://api.helpmyagent.com/v1/company/fr/benchmark`
- Price: `0.040 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

- Benchmarks a company against public peers using available revenue, net income, growth and margin metrics.
- You need to benchmark one French company against automatically selected public peers.
- You want available revenue, net-income, growth and margin comparisons with peer context.

## Avoid when

- You already have a fixed set of 2 to 5 companies to compare; use company/fr/compare.
- You only need the comparable-company list without metrics; use company/fr/peers.

## Limitations

- Benchmark quality depends on public financial data being available for the target and selected peers.
- The peer sample is an administrative/public-data comparison set, not an official industry benchmark.

## Freshness

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

## Sources

- [https://recherche-entreprises.api.gouv.fr](https://recherche-entreprises.api.gouv.fr)

## Input schema

```json
{
    "type": "object",
    "properties": {
        "identifier": {
            "type": "string",
            "pattern": "^[0-9]{9}([0-9]{5})?$",
            "description": "French company identifier: 9-digit SIREN or 14-digit SIRET."
        },
        "scope": {
            "type": "string",
            "enum": [
                "department",
                "region",
                "france"
            ],
            "default": "region",
            "description": "Geographic comparison scope controlling whether candidates are selected by department, region or all of France. (default region; allowed values: department, region, france)."
        },
        "peer_limit": {
            "type": "integer",
            "minimum": 2,
            "maximum": 10,
            "default": 5,
            "description": "Maximum number of comparable peer companies used by the benchmark. (minimum 2; maximum 10; default 5)."
        }
    },
    "required": [
        "identifier"
    ],
    "additionalProperties": false,
    "description": "Structured input parameters for the company/fr/benchmark API."
}
```

## Output schema

```json
{
    "type": "object",
    "properties": {
        "identifier": {
            "type": "string",
            "description": "Identifier supplied for the request, echoed in normalized form when applicable."
        },
        "exists": {
            "type": "boolean",
            "description": "Whether the requested company or public record was found in the checked source."
        },
        "siren": {
            "description": "Normalized 9-digit French SIREN when available."
        },
        "name": {
            "description": "Publicly available company, person, buyer or record name for this result."
        },
        "scope": {
            "type": "string",
            "description": "Structured value returned for “scope” as defined by this API contract."
        },
        "peer_count": {
            "type": "integer",
            "description": "Structured value returned for “peer count” as defined by this API contract."
        },
        "metrics": {
            "type": "object",
            "description": "Structured value returned for “metrics” as defined by this API contract."
        },
        "peers": {
            "type": "array",
            "description": "Structured value returned for “peers” as defined by this API contract."
        },
        "limitations": {
            "type": "array",
            "description": "Known interpretation, source-coverage or freshness limitations for this result."
        }
    },
    "required": [
        "identifier",
        "exists",
        "siren",
        "name",
        "scope",
        "peer_count",
        "metrics",
        "peers"
    ],
    "additionalProperties": false,
    "description": "Structured result returned by the company/fr/benchmark API."
}
```

## Demonstration snapshot

This example is a database-stored snapshot and does not execute the live API.
- URL: https://api.helpmyagent.com/demo/company/fr/benchmark
- Generated at: 2026-09-07T14:49:29+00:00

## Request example

```json
{
    "identifier": "356000000",
    "scope": "france",
    "peer_limit": 3
}
```

## Stored response example

```json
{
    "identifier": "356000000",
    "exists": true,
    "siren": "356000000",
    "name": "LA POSTE",
    "scope": "france",
    "peer_count": 1,
    "metrics": {
        "revenue": {
            "company_value": 34569000000,
            "peer_count": 1,
            "peer_median": 95719080,
            "peer_min": 95719080,
            "peer_max": 95719080
        },
        "net_income": {
            "company_value": 1722000000,
            "peer_count": 1,
            "peer_median": -1571345,
            "peer_min": -1571345,
            "peer_max": -1571345
        },
        "revenue_growth_percent": {
            "company_value": null,
            "peer_count": 0,
            "peer_median": null,
            "peer_min": null,
            "peer_max": null
        },
        "net_margin_percent": {
            "company_value": 4.98,
            "peer_count": 1,
            "peer_median": -1.64,
            "peer_min": -1.64,
            "peer_max": -1.64
        }
    },
    "peers": [
        {
            "siren": "409108115",
            "name": "SOCIETE DE TRAITEMENT DE PRESSE (STP)",
            "year": "2024",
            "revenue": 95719080,
            "net_income": -1571345,
            "revenue_growth_percent": null,
            "net_margin_percent": -1.64
        }
    ],
    "limitations": [
        "Le benchmark repose sur les pairs publics retournés par company/fr/peers et sur les comptes publics disponibles.",
        "Les exercices peuvent différer entre sociétés ; les valeurs absentes ne sont pas imputées."
    ]
}
```

## Billing policy

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