# French B2B company prospecting

Searches active French companies using structured public B2B filters such as activity, geography, size and supported certifications.

## Endpoint

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

- Searches active French companies using structured public B2B filters such as activity, geography, size and supported certifications.
- You need a list of active French companies matching structured B2B criteria such as activity, geography, size or supported certifications.
- You want prospect candidates before running deeper company checks.

## Avoid when

- You are looking for one known company by name, SIREN or SIRET; use company/fr/search.
- You need a radius search around coordinates; use company/fr/nearby.

## Limitations

- Prospecting coverage follows the public company and certification sources used by the selected filters.
- A filter match is a discovery signal, not proof of commercial suitability or current willingness to buy.

## Freshness

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

## Sources

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

## Input schema

```json
{
    "type": "object",
    "properties": {
        "query": {
            "type": "string",
            "description": "Optional company-name or free-text term combined with the structured prospecting filters."
        },
        "activity_code": {
            "type": "string",
            "description": "Optional French NAF activity code used to restrict or classify company results."
        },
        "activity_section": {
            "type": "string",
            "description": "Optional NAF activity section used to restrict company results."
        },
        "company_category": {
            "type": "string",
            "description": "Optional French company-size category used to restrict prospecting results."
        },
        "employee_band_code": {
            "type": "string",
            "description": "Optional official employee-band code used to restrict company results."
        },
        "postal_code": {
            "type": "string",
            "description": "Optional French postal code used to narrow results geographically."
        },
        "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."
        },
        "legal_form_code": {
            "type": "string",
            "description": "Optional French legal-form code used to restrict company results."
        },
        "rge": {
            "type": "boolean",
            "description": "When true, restrict results to companies with a supported public RGE qualification."
        },
        "bio": {
            "type": "boolean",
            "description": "When true, restrict results to companies found in the supported public organic/Bio certification source."
        },
        "qualiopi": {
            "type": "boolean",
            "description": "When true, restrict results to companies found in the supported public Qualiopi source."
        },
        "page": {
            "type": "integer",
            "minimum": 1,
            "default": 1,
            "description": "One-based result page number. (minimum 1; default 1)."
        },
        "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 25,
            "default": 25,
            "description": "Maximum number of records returned by this call. (minimum 1; maximum 25; default 25)."
        }
    },
    "additionalProperties": false,
    "description": "Structured input parameters for the company/fr/prospecting API."
}
```

## Output schema

```json
{
    "type": "object",
    "properties": {
        "filters": {
            "type": "object",
            "description": "Structured value returned for “filters” as defined by this API contract."
        },
        "page": {
            "type": "integer",
            "description": "Structured value returned for “page” as defined by this API contract."
        },
        "limit": {
            "type": "integer",
            "description": "Structured value returned for “limit” as defined by this API contract."
        },
        "total_count": {
            "type": "integer",
            "description": "Total number of matching records reported by the source or endpoint."
        },
        "returned_count": {
            "type": "integer",
            "description": "Number of records included in this response."
        },
        "truncated": {
            "type": "boolean",
            "description": "Whether additional matching records existed beyond the returned result limit."
        },
        "companies": {
            "type": "array",
            "description": "Structured company records returned by the endpoint."
        }
    },
    "required": [
        "filters",
        "page",
        "limit",
        "total_count",
        "returned_count",
        "truncated",
        "companies"
    ],
    "additionalProperties": false,
    "description": "Structured result returned by the company/fr/prospecting 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/prospecting
- Generated at: 2026-09-07T14:49:27+00:00

## Request example

```json
{
    "postal_code": "75015",
    "limit": 5
}
```

## Stored response example

```json
{
    "filters": {
        "postal_code": "75015",
        "limit": 5
    },
    "page": 1,
    "limit": 5,
    "total_count": 10000,
    "returned_count": 5,
    "truncated": true,
    "companies": [
        {
            "siren": "356000000",
            "name": "LA POSTE",
            "activity_code": "53.10Z",
            "legal_form_code": "5510",
            "company_category": "GE",
            "employee_band_code": "53",
            "creation_date": "1991-01-01",
            "headquarters": {
                "siret": "35600000000048",
                "address": "DIRECTION GENERALE DE LA POSTE 9 RUE DU COLONEL PIERRE AVIA 75015 PARIS",
                "postal_code": "75015",
                "city": "PARIS",
                "department": "75",
                "region": "11"
            }
        },
        {
            "siren": "552081317",
            "name": "ELECTRICITE DE FRANCE (EDF)",
            "activity_code": "35.11Z",
            "legal_form_code": "5599",
            "company_category": "GE",
            "employee_band_code": "53",
            "creation_date": "1955-01-01",
            "headquarters": {
                "siret": "55208131766522",
                "address": "22-30 22 AVENUE DE WAGRAM 75008 PARIS",
                "postal_code": "75008",
                "city": "PARIS",
                "department": "75",
                "region": "11"
            }
        },
        {
            "siren": "662025196",
            "name": "ELIOR RESTAURATION FRANCE (ELIOR RESTAURATION ENSEIGNEMENT - ELIOR RESTAURATION SANTE)",
            "activity_code": "56.29B",
            "legal_form_code": "5710",
            "company_category": "GE",
            "employee_band_code": "53",
            "creation_date": "1966-01-01",
            "headquarters": {
                "siret": "66202519676665",
                "address": "51 CHEMIN DES MECHES 94000 CRETEIL",
                "postal_code": "94000",
                "city": "CRETEIL",
                "department": "94",
                "region": "11"
            }
        },
        {
            "siren": "217500016",
            "name": "VILLE DE PARIS",
            "activity_code": "84.11Z",
            "legal_form_code": "7229",
            "company_category": "GE",
            "employee_band_code": "53",
            "creation_date": "1983-03-01",
            "headquarters": {
                "siret": "21750001600019",
                "address": "4 PL HOTEL VILLE ESP LIBERATION 75004 PARIS 04",
                "postal_code": "75004",
                "city": "PARIS 04",
                "department": "75",
                "region": "11"
            }
        },
        {
            "siren": "552120222",
            "name": "SOCIETE GENERALE (SG)",
            "activity_code": "64.19Z",
            "legal_form_code": "5599",
            "company_category": "GE",
            "employee_band_code": "53",
            "creation_date": "1900-01-01",
            "headquarters": {
                "siret": "55212022200013",
                "address": "29 BOULEVARD HAUSSMANN 75009 PARIS",
                "postal_code": "75009",
                "city": "PARIS",
                "department": "75",
                "region": "11"
            }
        }
    ]
}
```

## Billing policy

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