helpmyagent.com
FR Connect my AI
☰

French Public Buyer Profile

Builds a compact DECP profile for a French public buyer by name or SIRET.

0.020 USD

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

When to use this API?

Use for

  • Profile a French public buyer from its published contract records.

Avoid when

  • Use a more specific endpoint when you only need one already available primitive datum.

Limitations

  • Results depend on the availability and scope of the cited public sources.

Sources and provenance

Données essentielles de la commande publique

www.data.economie.gouv.fr

Input / Output schemas

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

OpenAPI 3.1 →

Input schema
buyerstring

Required

limitinteger

View full JSON Schema
{
    "type": "object",
    "properties": {
        "buyer": {
            "type": "string",
            "minLength": 2,
            "maxLength": 200
        },
        "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "default": 100
        }
    },
    "additionalProperties": false,
    "required": [
        "buyer"
    ]
}
Output schema
querystring

Required

source_statusstring

Required

buyer_siretstring | null

Required

buyer_namestring | null

Required

total_countinteger | null

Required

sampled_countinteger | null

Required

sampled_amountnumber | integer | null

Required

latest_notification_datestring | null

Required

by_yeararray

Required

top_cpvarray

Required

top_suppliersarray

Required

generated_atstring

Required

limitationsarray

View full JSON Schema
{
    "type": "object",
    "properties": {
        "query": {
            "type": "string"
        },
        "source_status": {
            "type": "string",
            "enum": [
                "ok",
                "unavailable"
            ]
        },
        "buyer_siret": {
            "type": [
                "string",
                "null"
            ]
        },
        "buyer_name": {
            "type": [
                "string",
                "null"
            ]
        },
        "total_count": {
            "type": [
                "integer",
                "null"
            ]
        },
        "sampled_count": {
            "type": [
                "integer",
                "null"
            ]
        },
        "sampled_amount": {
            "type": [
                "number",
                "integer",
                "null"
            ]
        },
        "latest_notification_date": {
            "type": [
                "string",
                "null"
            ]
        },
        "by_year": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "year": {
                        "type": "string"
                    },
                    "contracts_count": {
                        "type": "integer"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "year",
                    "contracts_count"
                ]
            }
        },
        "top_cpv": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "cpv": {
                        "type": "string"
                    },
                    "contracts_count": {
                        "type": "integer"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "cpv",
                    "contracts_count"
                ]
            }
        },
        "top_suppliers": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "siren": {
                        "type": "string"
                    },
                    "contracts_count": {
                        "type": "integer"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "siren",
                    "contracts_count"
                ]
            }
        },
        "generated_at": {
            "type": "string"
        },
        "limitations": {
            "type": "array",
            "items": {
                "type": "string"
            }
        }
    },
    "additionalProperties": false,
    "required": [
        "query",
        "source_status",
        "buyer_siret",
        "buyer_name",
        "total_count",
        "sampled_count",
        "sampled_amount",
        "latest_notification_date",
        "by_year",
        "top_cpv",
        "top_suppliers",
        "generated_at"
    ]
}

Example queries

Profile a French public buyer from its published contract records.