helpmyagent.com
FR Connect my AI
☰

French Company Opportunities

Ranks actionable French public funding and open procurement opportunities for a company using its profile, project context and historical public contracts.

0.020 USD

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

When to use this API?

Use for

  • You need company-specific actionable opportunities combining public aid matching and currently open public tenders.
  • You want opportunities ranked from the company profile, optional project context and historical public-contract evidence.

Avoid when

  • You need a broad open-tender search without company context; use procurement/fr/search.
  • You need a guarantee of aid eligibility, tender suitability or commercial success.

Limitations

  • PUBLIC_AID opportunities are produced only when a project is provided and matches the public taxonomy; they remain indicative, not official eligibility decisions.
  • PUBLIC_TENDER matching is intentionally conservative and relies on common CPV codes plus shared business vocabulary with historical awarded contracts; source coverage can be partial.

Sources and provenance

API Recherche d'entreprises

recherche-entreprises.api.gouv.fr

Aides-entreprises.fr — stock public des aides

data.aides-entreprises.fr

Données essentielles de la commande publique (DECP)

www.data.economie.gouv.fr

BOAMP Open Data

boamp-datadila.opendatasoft.com

Input / Output schemas

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

OpenAPI 3.1 →

Input schema
identifierstring

Required · 9-digit SIREN or 14-digit SIRET

projectstring

Optional project context used for public-aid and opportunity matching

limitinteger

Maximum number of ranked opportunities to return

View full JSON Schema
{
    "type": "object",
    "properties": {
        "identifier": {
            "type": "string",
            "pattern": "^[0-9]{9}([0-9]{5})?$",
            "description": "9-digit SIREN or 14-digit SIRET"
        },
        "project": {
            "type": "string",
            "minLength": 2,
            "description": "Optional project context used for public-aid and opportunity matching"
        },
        "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 25,
            "default": 10,
            "description": "Maximum number of ranked opportunities to return"
        }
    },
    "required": [
        "identifier"
    ],
    "additionalProperties": false
}
Output schema
identifierstring

Required

identifier_typestring

Required

existsboolean

Required

sirenstring | null

Required

namestring | null

Required

company_statusstring | null

Required

projectstring | null

Required

total_candidatesinteger

Required

returned_countinteger

Required

truncatedboolean

Required

opportunitiesarray

Required

coveragearray

Required

limitationsarray

View full JSON Schema
{
    "type": "object",
    "properties": {
        "identifier": {
            "type": "string"
        },
        "identifier_type": {
            "type": "string",
            "enum": [
                "siren",
                "siret"
            ]
        },
        "exists": {
            "type": "boolean"
        },
        "siren": {
            "type": [
                "string",
                "null"
            ]
        },
        "name": {
            "type": [
                "string",
                "null"
            ]
        },
        "company_status": {
            "type": [
                "string",
                "null"
            ]
        },
        "project": {
            "type": [
                "string",
                "null"
            ]
        },
        "total_candidates": {
            "type": "integer"
        },
        "returned_count": {
            "type": "integer"
        },
        "truncated": {
            "type": "boolean"
        },
        "opportunities": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "type": {
                        "type": "string",
                        "enum": [
                            "PUBLIC_AID",
                            "PUBLIC_TENDER"
                        ]
                    },
                    "score": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 1
                    },
                    "title": {
                        "type": "string"
                    },
                    "reasons": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        }
                    },
                    "source_data": {
                        "type": "object"
                    },
                    "sources": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        }
                    }
                },
                "required": [
                    "type",
                    "score",
                    "title",
                    "reasons",
                    "source_data",
                    "sources"
                ],
                "additionalProperties": false
            }
        },
        "coverage": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "service": {
                        "type": "string"
                    },
                    "status": {
                        "type": "string"
                    }
                },
                "required": [
                    "service",
                    "status"
                ],
                "additionalProperties": false
            }
        },
        "limitations": {
            "type": "array",
            "items": {
                "type": "string"
            }
        }
    },
    "required": [
        "identifier",
        "identifier_type",
        "exists",
        "siren",
        "name",
        "company_status",
        "project",
        "total_candidates",
        "returned_count",
        "truncated",
        "opportunities",
        "coverage"
    ],
    "additionalProperties": false
}

Example queries

What public opportunities are actionable for SIREN 356000000?
Rank grants and open tenders for this company’s digital-transformation project.
Which open tenders resemble contracts this company has already won?