# Compare French companies

Compares 2 to 5 French companies across public administrative, financial and legal-risk fields without producing a global winner.

## Endpoint

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

- Compares 2 to 5 French companies across public administrative, financial and legal-risk fields without producing a global winner.
- You already know 2 to 5 French company identifiers and want a side-by-side public-data comparison.
- You need comparable administrative, financial and legal-risk fields without declaring a global winner.

## Avoid when

- You need an automatically selected peer set and relative metrics; use company/fr/benchmark.
- You need details for only one company; use the relevant single-company endpoint.

## Limitations

- Comparability depends on which public fields are available for every supplied company.
- Missing public financial data can make some cross-company comparisons incomplete.

## Freshness

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

## Sources

- [https://recherche-entreprises.api.gouv.fr](https://recherche-entreprises.api.gouv.fr)
- [https://bodacc-datadila.opendatasoft.com/api/explore/v2.1/catalog/datasets/annonces-commerciales/records](https://bodacc-datadila.opendatasoft.com/api/explore/v2.1/catalog/datasets/annonces-commerciales/records)

## Input schema

```json
{
    "type": "object",
    "properties": {
        "identifiers": {
            "type": "array",
            "minItems": 2,
            "maxItems": 5,
            "items": {
                "type": "string",
                "pattern": "^[0-9]{9}([0-9]{5})?$"
            },
            "description": "List of French company identifiers to process; each item must be a 9-digit SIREN or 14-digit SIRET. (at least 2 items; at most 5 items)."
        }
    },
    "required": [
        "identifiers"
    ],
    "additionalProperties": false,
    "description": "Structured input parameters for the company/fr/compare API."
}
```

## Output schema

```json
{
    "type": "object",
    "properties": {
        "companies": {
            "type": "array",
            "description": "Structured company records returned by the endpoint."
        },
        "comparability": {
            "type": "object",
            "description": "Structured value returned for “comparability” as defined by this API contract."
        },
        "rankings": {
            "type": "object",
            "description": "Structured value returned for “rankings” as defined by this API contract."
        },
        "limitations": {
            "type": "array",
            "description": "Known interpretation, source-coverage or freshness limitations for this result."
        }
    },
    "required": [
        "companies",
        "comparability",
        "rankings"
    ],
    "additionalProperties": false,
    "description": "Structured result returned by the company/fr/compare 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/compare
- Generated at: 2026-09-07T14:49:21+00:00

## Request example

```json
{
    "identifiers": [
        "356000000",
        "552100554"
    ]
}
```

## Stored response example

```json
{
    "companies": [
        {
            "identifier": "356000000",
            "exists": true,
            "siren": "356000000",
            "name": "LA POSTE",
            "status": "active",
            "activity_code": "53.10Z",
            "company_category": "GE",
            "employee_band_code": "53",
            "creation_date": "1991-01-01",
            "latest_financial_year": "2024",
            "revenue": 34569000000,
            "net_income": 1722000000,
            "revenue_growth_percent": null,
            "net_margin_percent": 4.98,
            "legal_risk": "low"
        },
        {
            "identifier": "552100554",
            "exists": true,
            "siren": "552100554",
            "name": "PEUGEOT SA",
            "status": "closed",
            "activity_code": "70.10Z",
            "company_category": null,
            "employee_band_code": "NN",
            "creation_date": "1955-01-01",
            "latest_financial_year": "2019",
            "revenue": 74731000000,
            "net_income": 3584000000,
            "revenue_growth_percent": null,
            "net_margin_percent": 4.8,
            "legal_risk": "high"
        }
    ],
    "comparability": {
        "comparable": false,
        "issues": [
            "Les entreprises n’ont pas toutes le même code d’activité principal.",
            "Les derniers exercices financiers disponibles ne sont pas tous identiques."
        ]
    },
    "rankings": {
        "revenue": [
            {
                "identifier": "552100554",
                "name": "PEUGEOT SA",
                "value": 74731000000,
                "rank": 1
            },
            {
                "identifier": "356000000",
                "name": "LA POSTE",
                "value": 34569000000,
                "rank": 2
            }
        ],
        "net_income": [
            {
                "identifier": "552100554",
                "name": "PEUGEOT SA",
                "value": 3584000000,
                "rank": 1
            },
            {
                "identifier": "356000000",
                "name": "LA POSTE",
                "value": 1722000000,
                "rank": 2
            }
        ],
        "revenue_growth_percent": [],
        "net_margin_percent": [
            {
                "identifier": "356000000",
                "name": "LA POSTE",
                "value": 4.98,
                "rank": 1
            },
            {
                "identifier": "552100554",
                "name": "PEUGEOT SA",
                "value": 4.8,
                "rank": 2
            }
        ]
    },
    "limitations": [
        "Les classements sont fournis axe par axe et ne constituent jamais un classement global des entreprises.",
        "Les données financières peuvent porter sur des exercices différents et certaines sociétés peuvent ne publier aucun compte exploitable.",
        "Le niveau legal_risk reprend company/fr/risk et ne constitue pas un score de crédit."
    ]
}
```

## Billing policy

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