# Nearby French companies

Searches French companies around geographic coordinates using the official public company search geolocation endpoint.

## Endpoint

- Method: `POST`
- URL: `https://api.helpmyagent.com/v1/company/fr/nearby`
- Price: `0.010 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 French companies around geographic coordinates using the official public company search geolocation endpoint.
- You have geographic coordinates and need French companies within a radius.
- You want optional NAF activity filtering around a physical location.

## Avoid when

- You want structured B2B prospecting by region, size, legal form or certifications without coordinates; use company/fr/prospecting.
- You are searching for a known company by name or identifier; use company/fr/search.

## Limitations

- Results depend on geocoded establishment data exposed by the public company-search source.
- A geographic match indicates proximity, not a commercial relationship or service area.

## Freshness

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

## Sources

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

## Input schema

```json
{
    "type": "object",
    "properties": {
        "latitude": {
            "type": "number",
            "minimum": -90,
            "maximum": 90,
            "description": "Latitude in decimal degrees for the centre of the geographic search. (minimum -90; maximum 90)."
        },
        "longitude": {
            "type": "number",
            "minimum": -180,
            "maximum": 180,
            "description": "Longitude in decimal degrees for the centre of the geographic search. (minimum -180; maximum 180)."
        },
        "radius_km": {
            "type": "number",
            "exclusiveMinimum": 0,
            "maximum": 50,
            "default": 5,
            "description": "Search radius around the supplied coordinates, expressed in kilometres. (greater than 0; maximum 50; default 5)."
        },
        "activity_code": {
            "type": "string",
            "description": "Optional French NAF activity code used to restrict nearby-company results."
        },
        "activity_section": {
            "type": "string",
            "pattern": "^[A-U]$",
            "description": "Optional NAF activity section letter used to restrict nearby-company results."
        },
        "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 25,
            "default": 10,
            "description": "Maximum number of records returned by this call. (minimum 1; maximum 25; default 10)."
        }
    },
    "required": [
        "latitude",
        "longitude"
    ],
    "additionalProperties": false,
    "description": "Structured input parameters for the company/fr/nearby API."
}
```

## Output schema

```json
{
    "type": "object",
    "properties": {
        "latitude": {
            "type": "number",
            "description": "Structured value returned for “latitude” as defined by this API contract."
        },
        "longitude": {
            "type": "number",
            "description": "Structured value returned for “longitude” as defined by this API contract."
        },
        "radius_km": {
            "type": "number",
            "description": "Structured value returned for “radius km” as defined by this API contract."
        },
        "activity_code": {
            "description": "Structured value returned for “activity code” as defined by this API contract."
        },
        "activity_section": {
            "description": "Structured value returned for “activity section” 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": [
        "latitude",
        "longitude",
        "radius_km",
        "activity_code",
        "activity_section",
        "total_count",
        "returned_count",
        "truncated",
        "companies"
    ],
    "additionalProperties": false,
    "description": "Structured result returned by the company/fr/nearby 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/nearby
- Generated at: 2026-09-07T14:49:27+00:00

## Request example

```json
{
    "latitude": 48.8566,
    "longitude": 2.3522,
    "radius_km": 2,
    "limit": 5
}
```

## Stored response example

```json
{
    "latitude": 48.8566,
    "longitude": 2.3522,
    "radius_km": 2,
    "activity_code": null,
    "activity_section": null,
    "total_count": 10000,
    "returned_count": 5,
    "truncated": true,
    "companies": [
        {
            "siren": "356000000",
            "name": "LA POSTE",
            "status": "active",
            "activity_code": "53.10Z",
            "company_category": "GE",
            "headquarters": {
                "siret": "35600000000048",
                "address": "DIRECTION GENERALE DE LA POSTE 9 RUE DU COLONEL PIERRE AVIA 75015 PARIS",
                "postal_code": "75015",
                "city": "PARIS",
                "latitude": "48.831515159",
                "longitude": "2.2780898787"
            }
        },
        {
            "siren": "552081317",
            "name": "ELECTRICITE DE FRANCE (EDF)",
            "status": "active",
            "activity_code": "35.11Z",
            "company_category": "GE",
            "headquarters": {
                "siret": "55208131766522",
                "address": "22-30 22 AVENUE DE WAGRAM 75008 PARIS",
                "postal_code": "75008",
                "city": "PARIS",
                "latitude": "48.876235098",
                "longitude": "2.2979350788"
            }
        },
        {
            "siren": "662025196",
            "name": "ELIOR RESTAURATION FRANCE (ELIOR RESTAURATION ENSEIGNEMENT - ELIOR RESTAURATION SANTE)",
            "status": "active",
            "activity_code": "56.29B",
            "company_category": "GE",
            "headquarters": {
                "siret": "66202519676665",
                "address": "51 CHEMIN DES MECHES 94000 CRETEIL",
                "postal_code": "94000",
                "city": "CRETEIL",
                "latitude": "48.7859495598914",
                "longitude": "2.43896270636127"
            }
        },
        {
            "siren": "217500016",
            "name": "VILLE DE PARIS",
            "status": "active",
            "activity_code": "84.11Z",
            "company_category": "GE",
            "headquarters": {
                "siret": "21750001600019",
                "address": "4 PL HOTEL VILLE ESP LIBERATION 75004 PARIS 04",
                "postal_code": "75004",
                "city": "PARIS 04",
                "latitude": "48.856507956",
                "longitude": "2.3520586814"
            }
        },
        {
            "siren": "552120222",
            "name": "SOCIETE GENERALE (SG)",
            "status": "active",
            "activity_code": "64.19Z",
            "company_category": "GE",
            "headquarters": {
                "siret": "55212022200013",
                "address": "29 BOULEVARD HAUSSMANN 75009 PARIS",
                "postal_code": "75009",
                "city": "PARIS",
                "latitude": "48.872915957",
                "longitude": "2.3323864781"
            }
        }
    ]
}
```

## Billing policy

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