French B2B company prospecting

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

0.020 USD

Charged on valid result · Empty result not charged · Errors not charged

When to use this API?

Use for

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

Avoid when

  • Do not use this endpoint as a legal, regulated credit or guaranteed fraud-free decision unless explicitly stated otherwise.

Limitations

  • Coverage depends on the public sources listed for this endpoint.

Sources and provenance

recherche-entreprises.api.gouv.fr

recherche-entreprises.api.gouv.fr

Input / Output schemas

Simplified endpoint contracts. The complete schema remains available in OpenAPI 3.1.

OpenAPI 3.1 →

Input schema
querystring

activity_codestring

activity_sectionstring

company_categorystring

employee_band_codestring

postal_codestring

departmentstring

regionstring

legal_form_codestring

rgeboolean

bioboolean

qualiopiboolean

pageinteger

limitinteger

View full JSON Schema
{
    "type": "object",
    "properties": {
        "query": {
            "type": "string"
        },
        "activity_code": {
            "type": "string"
        },
        "activity_section": {
            "type": "string"
        },
        "company_category": {
            "type": "string"
        },
        "employee_band_code": {
            "type": "string"
        },
        "postal_code": {
            "type": "string"
        },
        "department": {
            "type": "string"
        },
        "region": {
            "type": "string"
        },
        "legal_form_code": {
            "type": "string"
        },
        "rge": {
            "type": "boolean"
        },
        "bio": {
            "type": "boolean"
        },
        "qualiopi": {
            "type": "boolean"
        },
        "page": {
            "type": "integer",
            "minimum": 1,
            "default": 1
        },
        "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 25,
            "default": 25
        }
    },
    "additionalProperties": false
}
Output schema
filtersobject

Required

pageinteger

Required

limitinteger

Required

total_countinteger

Required

returned_countinteger

Required

truncatedboolean

Required

companiesarray

Required

View full JSON Schema
{
    "type": "object",
    "properties": {
        "filters": {
            "type": "object"
        },
        "page": {
            "type": "integer"
        },
        "limit": {
            "type": "integer"
        },
        "total_count": {
            "type": "integer"
        },
        "returned_count": {
            "type": "integer"
        },
        "truncated": {
            "type": "boolean"
        },
        "companies": {
            "type": "array"
        }
    },
    "required": [
        "filters",
        "page",
        "limit",
        "total_count",
        "returned_count",
        "truncated",
        "companies"
    ],
    "additionalProperties": false
}