CFNEWS INFRA  ·  Documentation technique
API REST · OpenAPI 3.0

Le modèle de données
de l'API CFNEWS INFRA

Référence pour l'intégration de les données de l'infrastructure CFNEWS INFRA au sein de vos systèmes. Cette page synthétise la spécification https://api.cfnewsinfra.net/doc.json.

Console Swagger interactive Testez tous les endpoints en direct sur api.cfnewsinfra.net/doc
Document de référence — Octobre 2026 api.cfnewsinfra.net · v2.0.1

01 À propos de doc.json

Le fichier https://api.cfnewsinfra.net/doc.json est la spécification OpenAPI 3.0 de l'API REST CFNEWS INFRA. C'est à la fois un modèle de données et un contrat d'interface machine-readable.

Elle décrit, dans un format standard exploitable par vos outils :

  • les entités métier exposées — opérations, acteurs, sociétés, véhicules, actifs, actualités, personnalités, mouvements ;
  • chaque endpoint avec sa méthode HTTP, son chemin, ses paramètres typés (avec enum, formats, contraintes) ;
  • les schémas de réponse (succès et erreurs) ;
  • les règles d'authentification et la structure du quota.
Source de vérité. Toute évolution de l'API est immédiatement reflétée dans doc.json. C'est une spécification vivante, versionnée, sur laquelle vos intégrations peuvent s'appuyer.
Console Swagger : api.cfnewsinfra.net/doc
Le doc.json est aussi disponible sous forme de console interactive Swagger UI. Vous y testez l'intégralité de l'API depuis votre navigateur, sans installer le moindre outil : authentification Bearer, formulaires de paramètres typés, exécution réelle des requêtes, inspection des réponses JSON. Nous recommandons d'y faire un tour avant toute intégration.

02 Cartographie des entités

L'API CFNEWS INFRA organise son périmètre autour de huit entités principales. L'opération (deal) constitue l'objet pivot du modèle.

OPÉRATIONLBO · M&A · Build-upCap. Dév. · Innov.Financement ACTEURFonds · AvocatBanquier · Conseil~ Annuaire SOCIÉTÉCible · PortfolioEntreprise+ fiche entreprise VÉHICULEFCPR · FPCISLP · FCPRFonds gérés PERSONNALITÉDirigeant · AssociéConseilAnnuaire ACTUALITÉArticle éditorial MOUVEMENTNomination conseille / investit cible portfolio intervient géré par affiliée à Relation directeAssociation
Modèle conceptuel simplifié des entités exposées par l'API CFNEWS INFRA (l'entité Actif, rattachée aux opérations, figure dans le dictionnaire ci-dessous).

Dictionnaire des entités

EntitéDescription métierSchéma OpenAPI
OpérationDeal (Infrastructure, LBO, M&A Corporate, Build-up, Capital Développement, Capital Innovation, Financement, Bourse).Operation
ActeurFonds d'investissement, conseils financiers, conseils juridiques, prêteurs et sociétés intervenant sur les deals.Acteur
SociétéCibles, sociétés de portefeuille, entreprises.Societe
VéhiculeFonds d'investissement (FCPR, FPCI, SLP, SCR, FCPI, FIP, SCPI, OPCI, ETF…).Vehicule
PersonnalitéDirigeants, associés, professionnels de l'infrastructure et du financement (annuaire des personnalités).People
ActualitéArticles éditoriaux CFNEWS INFRA liés aux entités.Article
ArticlePreview
MouvementNominations, recrutements et changements de poste dans l'industrie.Mouvement
ActifActifs d'infrastructure (data centers, transports, énergies renouvelables, télécoms, eau…), rattachés aux opérations.Actif

03 Authentification & quota

L'API utilise une authentification Bearer Token (bearerAuth). Chaque appel doit présenter un token valide via l'en-tête Authorization.

Format de l'en-tête

Authorization: Bearer VOTRE_TOKEN
Accept: application/json

Endpoint quota

GET /v1/account/quota

Retourne l'état de votre quota mensuel d'utilisation.

Structure de l'objet quota

Chaque réponse de l'API inclut un objet quota permettant de suivre votre consommation en temps réel :

request_costinteger
Coût de la requête en cours, en nombre d'unités décomptées sur votre quota mensuel.
monthly_usedinteger
Nombre total d'unités utilisées depuis le début du mois civil en cours.
monthly_limitinteger
Limite mensuelle d'unités attribuée selon votre abonnement.
Astuce : compteur gratuit. La plupart des endpoints de recherche acceptent un paramètre ping=true. Lorsqu'il est positionné, l'API retourne uniquement le nombre total de résultats correspondant aux filtres, sans consommer de quota. Idéal pour des compteurs de tableau de bord ou des estimations avant une recherche complète.

04 Pagination & tri

Les endpoints de liste retournent leurs résultats sous forme paginée, avec métadonnées de navigation et le total de résultats correspondant aux filtres.

Paramètres communs

pageinteger · défaut 1
Numéro de la page à charger. Doit être supérieur ou égal à 1.
sortstring · enum
Champ de tri (les valeurs autorisées varient selon l'endpoint : publication_date, modification_date, name, created_at, last_update_analyst…).
sort_directionstring · enum
Sens du tri : asc (ascendant) ou desc (descendant, par défaut sur la plupart des endpoints).
pingboolean
Si true, retourne uniquement total sans consommer de quota.

Métadonnées de pagination dans la réponse

countinteger
Nombre de résultats présents sur la page courante.
totalinteger
Nombre total de résultats correspondant aux filtres (toutes pages confondues).
pageinteger
Numéro de la page courante.
nb_pagesinteger
Nombre total de pages disponibles.
itemsarray
Tableau de résultats. Le schéma des items varie selon l'endpoint (Operation, ArticlePreview, OperationVehicule…).
quotaobject
Objet quota (cf. section 03).
Portefeuilles paginés selon votre abonnement. Les endpoints /v1/acteur/portfolio_now/{id}, /v1/acteur/portfolio_sortie/{id} et leurs équivalents véhicule retournent autant d'items par page que la limite de votre abonnement (30 lignes avec API STARTER, 25 en test). Pour récupérer la totalité d'un portefeuille, bouclez sur page=1, 2, 3… jusqu'à atteindre nb_pages.

05 Filtrage & référentiels

L'API CFNEWS INFRA propose un système de filtrage typé et contractuel : chaque filtre est documenté dans le doc.json avec son type, ses valeurs autorisées (enum) et ses contraintes.

Filtres typés (recommandé)

Les endpoints de recherche exposent des paramètres explicites, fortement typés, qui permettent une intégration robuste. Exemples pour /v1/operation :

op_type[]integer · enum
Type d'opération. Valeurs : 375868 (Bourse), 499644 (Build-up), 375876 (Capital Développement), 375875 (Capital Innovation), 375877 (Financement), 375871 (Infrastructure), 375874 (LBO), 375873 (M&A Corporate).
sector[]integer · enum
Secteur d'activité de la cible (25 valeurs : Agriculture & alimentaire, Biotechnologies, Logiciel et services informatiques, Santé…). Identifiants : /v1/operation/field-values?field[]=sector.
region[]integer · enum
Région administrative française de la cible (20 valeurs : Île-de-France, Auvergne-Rhône-Alpes, …).
department[]string · enum
Département français de la cible (75, 92, 69, 2A, 2B, 971 à 976…).
op_nationality[]string · ISO 3166-1 alpha-2
Nationalité de la cible au format ISO (FR, US, GB, DE…). Valeur spéciale EU = Europe, WD = Monde.
depuisstring · format d/m/Y
Date d'opération de début (format JJ/MM/AAAA, exemple : 01/01/2025).
jusquaustring · format d/m/Y
Date d'opération de fin.
op_keywords[]integer · enum (max 6)
Mots-clés thématiques de l'opération. Plus de 250 valeurs disponibles (5G, agrivoltaïsme, amorçage, aménagement…), identifiants via field-values.
VALtranche[]string · enum
Fourchette de valorisation de la cible en M€ : 0-20, 20-50, 50-150, 150-250, 250-500, 500-1000, >1000, n.d..

La liste ci-dessus est un extrait. /v1/operation expose à elle seule plus de 70 paramètres typés. La spécification doc.json reste la source exhaustive.

Endpoint field-values — référentiels dynamiques

Pour chaque entité, un endpoint dédié permet de récupérer dynamiquement les valeurs autorisées d'un champ filtrable. Utile pour alimenter des dropdowns ou valider une saisie côté client.

GET/v1/operation/field-values

Valeurs possibles pour les champs des opérations.

GET/v1/acteur/field-values

Valeurs possibles pour les champs des acteurs.

GET/v1/societe/field-values

Valeurs possibles pour les champs des sociétés.

GET/v1/vehicule/field-values

Valeurs possibles pour les champs des véhicules.

GET/v1/people/field-values

Valeurs possibles pour les champs des personnalités.

GET/v1/mouvement/field-values

Valeurs possibles pour les champs des mouvements.

GET/v1/actualite/field-values

Valeurs possibles pour les champs des actualités.

GET/v1/actif/field-values

Valeurs possibles pour les champs des actifs.

Chaque endpoint field-values accepte un paramètre field[] indiquant les champs dont vous souhaitez la liste des valeurs.

Bonne pratique. Utilisez les filtres typés (op_type[], sector[], region[]…) plutôt que la recherche textuelle. Vous bénéficiez d'une validation contractuelle, d'une meilleure performance, et vos intégrations restent compatibles à long terme.
Console Swagger interactive. Tous les filtres décrits ci-dessus sont testables en direct sur api.cfnewsinfra.net/doc. Sélectionnez l'endpoint, remplissez le formulaire généré à partir de la spécification, exécutez la requête et observez immédiatement la réponse JSON.

06 Catalogue des endpoints

L'API expose une quarantaine d'endpoints organisés par tag fonctionnel. Tableau synthétique ci-dessous, spécification complète dans doc.json.

Référentiels (recherche)

MéthodeCheminDescription
GET/v1/operationRecherche d'opérations (deals) avec filtres typés
GET/v1/operation/{id}Détail complet d'une opération
GET/v1/vehiculeRecherche de véhicules d'investissement
GET/v1/vehicule/{id}Détail d'un véhicule
GET/v1/acteurRecherche d'acteurs (fonds, conseils financiers et juridiques, prêteurs)
GET/v1/acteur/{id}Détail d'un acteur
GET/v1/acteurs/fund_listListe paginée des fonds d'investissement
GET/v1/societeRecherche de sociétés
GET/v1/societe/{id}Détail d'une société
GET/v1/mouvementRecherche de mouvements (nominations)
GET/v1/mouvement/{id}Détail d'un mouvement
GET/v1/mouvement/silent-movePersonnalités en transition, rattachées à la fiche placeholder « NON RATTACHE(E) »
GET/v1/peopleRecherche de personnalités
GET/v1/people/{id}Détail d'une personnalité
GET/v1/actifRecherche d'actifs d'infrastructure
GET/v1/actif/{id}Détail d'un actif
GET/v1/actualiteRecherche d'articles éditoriaux
GET/v1/actualite/{id}Contenu complet d'un article
GET/v1/actualite/{id}/tableau_pdf/{fileId}PDF d'un article (tableau, classement complet) — gratuit

Portfolios & deal lists

MéthodeCheminDescription
GET/v1/acteur/portfolio_now/{id}Portefeuille actuel d'un acteur
GET/v1/acteur/portfolio_sortie/{id}Sorties (exits) d'un acteur
GET/v1/acteur/op_conseillees/{id}Opérations conseillées par un acteur
GET/v1/acteur/op_capitalistiques/{id}Opérations capitalistiques d'un acteur
GET/v1/acteur/associated_buildups/{id}Build-ups associés à un acteur
GET/v1/acteur/managed_vehicles/{id}Véhicules gérés par un acteur
GET/v1/acteur/sponsor_vehicles/{id}Véhicules sponsorisés par un acteur
GET/v1/vehicule/portfolio_now/{id}Portefeuille actuel d'un véhicule
GET/v1/vehicule/portfolio_sortie/{id}Sorties d'un véhicule
GET/v1/vehicule/fundraising/{id}Opérations de levée d'un véhicule
GET/v1/societe/op_conseillees/{id}Opérations conseillées par une société
GET/v1/societe/op_capitalistiques/{id}Opérations capitalistiques d'une société

Field-values (référentiels dynamiques)

MéthodeCheminEntité concernée
GET/v1/operation/field-valuesOpérations
GET/v1/acteur/field-valuesActeurs
GET/v1/societe/field-valuesSociétés
GET/v1/vehicule/field-valuesVéhicules
GET/v1/people/field-valuesPersonnalités
GET/v1/mouvement/field-valuesMouvements
GET/v1/actif/field-valuesActifs
GET/v1/actualite/field-valuesActualités

Compte

MéthodeCheminDescription
GET/v1/account/quotaÉtat du quota mensuel
Explorez chaque endpoint sur Swagger. Chaque chemin listé ici est disponible dans la console Swagger interactive avec son schéma de paramètres, ses réponses d'exemple et un bouton « Try it out » qui exécute l'appel réel sur l'API.

07 Schémas de réponse

Les endpoints de liste partagent une enveloppe de réponse standard, qui combine données paginées, métadonnées et information de quota.

Enveloppe paginée

{
  "count":    5,           // résultats sur la page courante
  "total":    30,          // total correspondant aux filtres
  "page":     2,           // page courante
  "nb_pages": 2,           // nombre total de pages
  "quota": {
    "request_cost":  2,
    "monthly_used":  52,
    "monthly_limit": 2000
  },
  "items": [ /* tableau d'objets (Operation, ArticlePreview, …) */ ]
}

Endpoint détail

Les endpoints /v1/{entité}/{id} retournent directement l'objet complet (sans enveloppe paginée). Le schéma de chaque entité est défini dans components/schemas du doc.json : Operation, Article, OperationVehicule, Erreur…

Schéma d'erreur

Toutes les erreurs (4xx, 5xx) utilisent un schéma unifié Erreur permettant un traitement programmatique cohérent.

08 Codes d'erreur

L'API retourne des codes HTTP standards accompagnés d'un code applicatif identifiant la cause précise de l'erreur.

HTTPCode applicatifSignificationAction recommandée
200 — Succès Réponse normale.
400 bad_request Erreur dans votre requête Vérifier le format des paramètres et leurs valeurs autorisées (enum).
403 forbidden Accès non autorisé Vérifier le token Bearer et les droits associés à l'abonnement.
403 limit_exceeded Quota mensuel dépassé Surveiller quota.monthly_used dans les réponses.
404 — Ressource introuvable Vérifier l'{id} de la ressource demandée.
422 too_broad_search Recherche trop large Ajouter des filtres pour réduire le volume de résultats.
429 too_many_requests Trop de requêtes successives Implémenter un délai entre les appels (backoff exponentiel recommandé).
500 internal_error Erreur interne Réessayer après quelques secondes. Si le problème persiste, contacter le support.

09 Paramètres de recherche par type de fiche

C'est le cœur de l'API. Chaque endpoint de recherche accepte un ensemble riche de paramètres typés — appelés queries dans la suite — qui correspondent exactement aux filtres disponibles dans l'interface cfnewsinfra.net. Construire des queries précises est le levier principal pour obtenir des résultats pertinents en limitant la consommation de quota.

Bonne pratique : ne pas confondre q et les filtres typés. Le paramètre q reste accepté pour des cas hérités (URLs copiées du site), mais tous les nouveaux développements doivent utiliser les paramètres typés (op_type[], sector[], region[], etc.). Ils sont contractuels, validés par schéma enum, et garantis stables dans le temps.

Tableau de synthèse — combien de filtres par endpoint ?

EndpointType de ficheNb filtres typésFiltres clés
/v1/operationOpérations / Deals32depuis, jusquau, op_type[], op_sstype[], Montantmin …
/v1/vehiculeVéhicules d'investissement32vehicle_nom, vehicle_soc_nom, vehicle_invest, vehicle_advice, vehicle_segment[] …
/v1/acteurActeurs (fonds, conseils…)44acteur_nom, uniqut_citation_article, tranche_invest[], aum_min, aum_max …
/v1/societeSociétés (cibles, portefeuilles…)31soc_nom, soc_region[], soc_dpt[], soc_zone[], soc_activity[] …
/v1/mouvementMouvements / Nominations18mvt_nom, mvt_category, mvt_nationality, mvt_dureemin, mvt_dureemax …
/v1/peoplePersonnalités34people_nom, people_domaine, people_practice, people_region[], people_dpt[] …
/v1/actualiteArticles~14title, sector[], theme[], keyword[], related-actor[], date_between …
/v1/actifActifs d'infrastructure5asset_name, asset_region[], asset_type[], asset_ca_interval[], asset_nationality[] …
La liste exhaustive des filtres par endpoint est disponible dans la console Swagger (cliquer sur un endpoint → section Parameters). Les pages ci-dessous synthétisent les filtres les plus utiles avec exemples de valeurs.

9.1 — /v1/operation · Recherche d'opérations

Interroge la base de deals CFNEWS INFRA : nature du deal, cible, acquéreur/cédant, conseils, valorisation, dates, mots-clés. 32 filtres typés — liste générée depuis le formulaire de recherche du site.

ParamètreTypeDescription & valeurs
depuisdateDate d'opération - Début · format d/m/Y
jusquaudateDate d'opération - Fin · format d/m/Y
op_type[]int[]Type d'opération · Valeurs : 375868 Bourse · 499644 Build-up · 375876 Capital Développement · 375875 Capital Innovation · 375877 Financement · 375871 Infrastructure · 375874 LBO · 375873 M&A Corporate
op_sstype[]int[]Sous-type d'opération
50 valeurs — identifiants : /v1/operation/field-values?field[]=op_sstype
requiert op_type
MontantminnumberMontant de l'opération (en M€) - min
MontantmaxnumberMontant de l'opération (en M€) - max
CAtranche[]string[]Fourchette de montant · Valeurs : 0-20 Entre 0 et 20 · 20-50 Entre 20 et 50 · 50-150 Entre 50 et 150 · 150-250 Entre 150 et 250 · 250-500 Entre 250 et 500 · 500-1000 Entre 500 et 1000 · >1000 Plus de 1000 · n.d. Non déterminé
uniqut_avec_montantboolExclure les opérations sans indication de montant ou de valorisation · valeur attendue : oui
op_keywords[]int[]Mots clés — Recherche les opérations qui contiennent tous les mots clés sélectionnés · 260 valeurs — identifiants : /v1/operation/field-values?field[]=op_keywords
op_conseilstringConseils, préteur(s)
vehicle_usedstringVéhicule utilisé
op_nomstringActif ou société cible
op_nationality[]string[]Nationalité / Secteur géographique · 250 valeurs
region[]int[]Région(s) de la cible (France) · 20 valeurs — identifiants : /v1/operation/field-values?field[]=region
department[]string[]Département(s) de la cible (France) · 101 valeurs
asset_type[]int[]Type d'actif · 15 valeurs — identifiants : /v1/operation/field-values?field[]=asset_type
ca_interval[]string[]Chiffre d'affaires · Valeurs : 0-20 Entre 0 et 20 · 20-50 Entre 20 et 50 · 50-150 Entre 50 et 150 · 150-250 Entre 150 et 250 · 250-500 Entre 250 et 500 · 500-1000 Entre 500 et 1000 · >1000 Plus de 1000 · n.d. Non déterminé
op_valorisationminnumberValorisation (en M€) - min
op_valorisationmaxnumberValorisation (en M€) - max
VALtranche[]string[]Fourchette de valorisation (en M€) · Valeurs : 0-20 Entre 0 et 20 · 20-50 Entre 20 et 50 · 50-150 Entre 50 et 150 · 150-250 Entre 150 et 250 · 250-500 Entre 250 et 500 · 500-1000 Entre 500 et 1000 · >1000 Plus de 1000 · n.d. Non déterminé
inclure_montant_fourchetteboolInclure les fourchettes correspondantes si la valorisation exacte n'est pas connue · valeur attendue : oui
op_investstringAcquéreur(s), investisseur(s) ou cédant(s)
buyer_solder_content_type[]string[]Type d'acteur · Valeurs : fiche_financial_advice Conseil financier · fiche_legal_advice Conseil juridique · fiche_fond Investisseurs · fiche_societe Sociétés
op_nationality_solder_buyer[]string[]Nationalité(s) acquéreur(s)/cédant(s) — Choix Etranger = tout sauf France · 251 valeurs
op_invest_operatorstringOpérateur logique acquéreurs/cédants · 2 valeurs
region_buyer[]int[]Région acquéreur(s) · 20 valeurs — identifiants : /v1/operation/field-values?field[]=region_buyer
CAtrancheBuyer[]string[]Fourchette CA de l'acquéreur · Valeurs : 0-5 Entre 0 et 5 · 5-10 Entre 5 et 10 · 10-15 Entre 10 et 15 · 15-20 Entre 15 et 20 · 0-20 Entre 0 et 20 · 20-50 Entre 20 et 50 · 50-150 Entre 50 et 150 · 150-250 Entre 150 et 250 · 250-500 Entre 250 et 500 · 500-1000 Entre 500 et 1000 · >1000 Plus de 1000 · n.d. Non déterminé
uniqut_isbuyertechboolEntreprise de la TECH uniquement (acquéreur)
op_buyer_nationalitystringNationalité de l'acquéreur · Valeurs : FR France · ETRANGER Étranger
op_buyerboolRestreindre aux acquéreurs / investisseurs · valeur attendue : oui
op_solderboolRestreindre aux cédants · valeur attendue : oui
keyword_operatorstringOpérateur logique entre mots-clés — Opérateur appliqué entre les mots-clés de `op_keywords[]`. `OR` (par défaut) : au moins un mot-clé doit matcher. `AND` : tous les mots-clés doivent matcher. · Valeurs : OR OR (par défaut) · AND AND

9.2 — /v1/acteur · Recherche d'acteurs

Annuaire des fonds d'investissement, conseils financiers et juridiques, prêteurs. Plusieurs filtres dépendent du type d'acteur (paramètre acteur_domaine). 44 filtres typés — liste générée depuis le formulaire de recherche du site.

ParamètreTypeDescription & valeurs
acteur_nomstringNom (investisseur ou conseil)
uniqut_citation_articleboolEst cité dans un article CFNEWS INFRA
tranche_invest[]int[]Fourchette montant investissements (Fonds uniquement) · Valeurs : 375974 50-150 · 375975 20-50 · 375976 0-20 · 375969 TBD · 375970 1000+ · 375971 500-1000 · 375972 250-500 · 375973 150-250
aum_minnumberMontant sous gestion / AUM (M€) Min
aum_maxnumberMontant sous gestion / AUM (M€) Max
investment_typeintType d'investisseur (fonds uniquement) · 19 valeurs — identifiants : /v1/acteur/field-values?field[]=investment_type
asset_typeintType(s) d'actif(s) visé(s) · 15 valeurs — identifiants : /v1/acteur/field-values?field[]=asset_type
fund_typeboolFonds infra (Pure Player) uniquement
acteur_domaine[]int[]Catégorie (Investisseur, conseil financier...) · Valeurs : 448199 Conseil financier · 448198 Conseil juridique · 448197 Investisseurs
acteur_sous_domaine[]int[]Sous domaine d'activité ou expertise · 74 valeurs — identifiants : /v1/acteur/field-values?field[]=acteur_sous_domaine
acteur_zone[]string[]Nationalité (organisation) · 250 valeurs
risk_profileintProfil de risque · Valeurs : 375039 core · 375040 core+ · 375042 opportunist · 375041 value-added
acteur_region[]int[]Région (organisation) · 20 valeurs — identifiants : /v1/acteur/field-values?field[]=acteur_region
acteur_dpt[]string[]Département (organisation) · 101 valeurs
op_date_start_datedateDate d'opération - Début — Filtre du Deal Tracker : recherche les acteurs d'après les deals auxquels ils sont liés sur une période donnée. Début de la période d'opération. Déclencheur du Deal Tracker : les autres filtres deals ne s'appliquent que si une période est renseignée.
format d/m/Y
incompatible avec fund_focus
op_date_end_datedateDate d'opération - Fin — Filtre du Deal Tracker : recherche les acteurs d'après les deals auxquels ils sont liés sur une période donnée. Fin de la période d'opération. Déclencheur du Deal Tracker.
format d/m/Y
incompatible avec fund_focus
op_asset_type[]int[]Type d'actif visés (deals) · 15 valeurs — identifiants : /v1/acteur/field-values?field[]=op_asset_type
op_type[]int[]Type d'opération (si date d'opération renseignée) — Filtre du Deal Tracker : recherche les acteurs d'après les deals auxquels ils sont liés sur une période donnée. Type(s) d'opération des deals recherchés.
Valeurs : 375868 Bourse · 499644 Build-up · 375876 Capital Développement · 375875 Capital Innovation · 375877 Financement · 375871 Infrastructure · 375874 LBO · 375873 M&A Corporate
incompatible avec fund_focus
op_sstype[]int[]Sous-type d'opération (si date d'opération renseignée) — Filtre du Deal Tracker : recherche les acteurs d'après les deals auxquels ils sont liés sur une période donnée. Sous-type(s) d'opération des deals recherchés.
50 valeurs — identifiants : /v1/acteur/field-values?field[]=op_sstype
incompatible avec fund_focus
CAtranche[]string[]Fourchette de montant (M€) · Valeurs : 0-20 Entre 0 et 20 · 20-50 Entre 20 et 50 · 50-150 Entre 50 et 150 · 150-250 Entre 150 et 250 · 250-500 Entre 250 et 500 · 500-1000 Entre 500 et 1000 · >1000 Plus de 1000 · n.d. Non déterminé
acteur_role[]string[]Rôles (deals) — Filtre du Deal Tracker : recherche les acteurs d'après les deals auxquels ils sont liés sur une période donnée. Rôle(s) dans les deals (acquéreur, cédant, cible, conseil…).
74 valeurs
incompatible avec fund_focus
op_actor_category[]string[]Catégorie de la cible — Filtre du Deal Tracker : recherche les acteurs d'après les deals auxquels ils sont liés sur une période donnée. Catégorie de la cible du deal.
Valeurs : fiche_financial_advice Conseil financier · fiche_legal_advice Conseil juridique · fiche_fond Investisseurs · fiche_societe Sociétés
incompatible avec fund_focus
VALtranche[]string[]Fourchette de valorisation (en M€) — Filtre du Deal Tracker : recherche les acteurs d'après les deals auxquels ils sont liés sur une période donnée. Fourchette de valorisation de la cible (M€).
Valeurs : 0-20 Entre 0 et 20 · 20-50 Entre 20 et 50 · 50-150 Entre 50 et 150 · 150-250 Entre 150 et 250 · 250-500 Entre 250 et 500 · 500-1000 Entre 500 et 1000 · >1000 Plus de 1000 · n.d. Non déterminé
incompatible avec fund_focus
ca_interval[]string[]Fourchette de CA de la cible (M€) — Filtre du Deal Tracker : recherche les acteurs d'après les deals auxquels ils sont liés sur une période donnée. Fourchette de CA de la cible (M€).
Valeurs : 0-20 Entre 0 et 20 · 20-50 Entre 20 et 50 · 50-150 Entre 50 et 150 · 150-250 Entre 150 et 250 · 250-500 Entre 250 et 500 · 500-1000 Entre 500 et 1000 · >1000 Plus de 1000 · n.d. Non déterminé
incompatible avec fund_focus
op_keywords_df[]int[]Mots-clés (deals) — Filtre du Deal Tracker : recherche les acteurs d'après les deals auxquels ils sont liés sur une période donnée. Mots-clés des deals.
260 valeurs — identifiants : /v1/acteur/field-values?field[]=op_keywords_df
incompatible avec fund_focus
op_region[]int[]Région(s) (deals) — Filtre du Deal Tracker : recherche les acteurs d'après les deals auxquels ils sont liés sur une période donnée. Région(s) de la cible des deals.
20 valeurs — identifiants : /v1/acteur/field-values?field[]=op_region
incompatible avec fund_focus
display_actor_deal_topboolGénérer un classement (League table) — League Tables : génère un classement des acteurs les plus actifs sur la période, classés par nombre de deals correspondant aux filtres du Deal Tracker. Activer avec la valeur `true`. Incompatible avec `no_deal` (un classement sans deal n'a pas de sens).
valeur attendue : Générer un classement
incompatible avec fund_focus
uniqut_istechboolFonds TECH · valeur attendue : oui
invest_minnumberMontant des investissements (M€) Min
invest_maxnumberMontant des investissements (M€) Max
portfolio_now[]string[]Nb de sociétés en portefeuille (fonds uniquement) · Valeurs : 0-5 Entre 0 et 5 · 5-10 Entre 5 et 10 · 10-15 Entre 10 et 15 · 15-20 Entre 15 et 20 · 0-20 Entre 0 et 20 · 20-50 Entre 20 et 50 · 50-150 Entre 50 et 150 · 150-250 Entre 150 et 250 · 250-500 Entre 250 et 500 · 500-1000 Entre 500 et 1000 · >1000 Plus de 1000
include_regional_officesboolInclure les bureaux régionaux · valeur attendue : 1
acteur_secteur[]int[]Secteurs d'activités (deals) — Filtre du Deal Tracker : recherche les acteurs d'après les deals auxquels ils sont liés sur une période donnée. Secteur(s) d'activité des deals.
25 valeurs — identifiants : /v1/acteur/field-values?field[]=acteur_secteur
incompatible avec fund_focus
op_descstringDescriptif d'activité (deals) — Filtre du Deal Tracker : recherche les acteurs d'après les deals auxquels ils sont liés sur une période donnée. Mots recherchés dans le descriptif d'activité des deals. · incompatible avec fund_focus
no_dealboolSans deal sur la période — Filtre du Deal Tracker : recherche les acteurs d'après les deals auxquels ils sont liés sur une période donnée. Ne renvoie que les acteurs SANS aucun deal sur la période.
valeur attendue : no_deal
incompatible avec fund_focus
op_exclude_actor_cibleboolExclure si l'acteur est la cible — Filtre du Deal Tracker : recherche les acteurs d'après les deals auxquels ils sont liés sur une période donnée. Exclut les deals où l'acteur est lui-même la cible.
valeur attendue : true
incompatible avec fund_focus
op_cible_techboolCible TECH uniquement — Filtre du Deal Tracker : recherche les acteurs d'après les deals auxquels ils sont liés sur une période donnée. Restreint aux deals dont la cible est une entreprise TECH.
valeur attendue : true
incompatible avec fund_focus
CAtrancheDF[]string[]Fourchette montant opération (M€) — Filtre du Deal Tracker : recherche les acteurs d'après les deals auxquels ils sont liés sur une période donnée. Fourchette de montant de l'opération (M€).
Valeurs : 0-5 Entre 0 et 5 · 5-10 Entre 5 et 10 · 10-15 Entre 10 et 15 · 15-20 Entre 15 et 20 · 0-20 Entre 0 et 20 · 20-50 Entre 20 et 50 · 50-150 Entre 50 et 150 · 150-250 Entre 150 et 250 · 250-500 Entre 250 et 500 · 500-1000 Entre 500 et 1000 · >1000 Plus de 1000 · n.d. Non déterminé
incompatible avec fund_focus
league_table_limitintTaille du classement (top N) — League Tables : nombre d'entrées du classement (taille du top N). N'a d'effet que si `display_actor_deal_top` est activé. Valeurs autorisées : 5, 10, 20, 40, 50 ; toute autre valeur est ramenée à la valeur autorisée inférieure la plus proche (pas d'erreur). Défaut : 50.
5 valeurs — identifiants : /v1/acteur/field-values?field[]=league_table_limit
requiert display_actor_deal_top
incompatible avec fund_focus
fund_focusboolUniquement dans le portefeuille actuel d'un fonds — Fund Focus : ne renvoie que les acteurs actuellement présent(e)s dans le portefeuille d'un fonds / société de gestion. Activer avec la valeur `true`. · valeur attendue : true
keyword_operatorstringOpérateur logique entre mots-clés — Opérateur appliqué entre les mots-clés de `op_keywords[]`. `OR` (par défaut) : au moins un mot-clé doit matcher. `AND` : tous les mots-clés doivent matcher. · Valeurs : OR OR (par défaut) · AND AND
fund_focus_detention_yearintDurée de détention (années) — Fund Focus : durée de détention en portefeuille ciblée (en années). · requiert fund_focus
fund_focus_detention_year_range-minintDurée de détention min (années) — Fund Focus : durée de détention minimale (fourchette, en années). TOUJOURS À RENSEIGNER AVEC fund_focus_detention_year_range-max — les deux bornes vont par paire, jamais l'une sans l'autre. Pour un minimum ouvert ("plus de X ans"), borner le haut avec la valeur maximale autorisée du champ (ex. min=5 ET max=10). · requiert fund_focus
fund_focus_detention_year_range-maxintDurée de détention max (années) — Fund Focus : durée de détention maximale (fourchette, en années). TOUJOURS À RENSEIGNER AVEC fund_focus_detention_year_range-min — les deux bornes vont par paire, jamais l'une sans l'autre. Pour un maximum ouvert ("moins de X ans"), borner le bas avec la valeur minimale autorisée du champ (ex. min=0 ET max=3). · requiert fund_focus

9.3 — /v1/societe · Recherche de sociétés

Cibles, sociétés de portefeuille et entreprises du référentiel. 31 filtres typés — liste générée depuis le formulaire de recherche du site.

ParamètreTypeDescription & valeurs
soc_nomstringNom
soc_region[]int[]Région · 20 valeurs — identifiants : /v1/societe/field-values?field[]=soc_region
soc_dpt[]string[]Département · 101 valeurs
soc_zone[]string[]Nationalité · 250 valeurs
soc_activity[]int[]Type · Valeurs : 375967 Cotée · 376014 Familiale · 376035 Filiale Groupe · 376034 Indépendante · 376033 Sté en LBO · 506506 Sté en redressement · 376032 Sté liquidée
soc_ca_interval[]string[]Fourchette de CA · Valeurs : 0-20 Entre 0 et 20 · 20-50 Entre 20 et 50 · 50-150 Entre 50 et 150 · 150-250 Entre 150 et 250 · 250-500 Entre 250 et 500 · 500-1000 Entre 500 et 1000 · >1000 Plus de 1000
VALtrancheCompany[]string[]Fourchette de valorisation (M€) — Dernière valorisation connue selon la base de deals CFNEWS · Valeurs : 0-20 Entre 0 et 20 · 20-50 Entre 20 et 50 · 50-150 Entre 50 et 150 · 150-250 Entre 150 et 250 · 250-500 Entre 250 et 500 · 500-1000 Entre 500 et 1000 · >1000 Plus de 1000 · n.d. Non déterminé
sector[]int[]Secteur d'activité · 25 valeurs — identifiants : /v1/societe/field-values?field[]=sector
soc_keywords[]int[]Mots clés — Recherche les sociétés qui contiennent tous les mots clés sélectionnés · 260 valeurs — identifiants : /v1/societe/field-values?field[]=soc_keywords
creation_year_minnumberAnnée de création (min)
creation_year_maxnumberAnnée de création (max)
op_date_start_datedateDate opération (début) — Filtre du Deal Tracker : recherche les sociétés d'après les deals auxquels ils sont liés sur une période donnée. Début de la période d'opération. Déclencheur du Deal Tracker : les autres filtres deals ne s'appliquent que si une période est renseignée.
format d/m/Y
incompatible avec fund_focus
op_date_end_datedateDate opération (fin) — Filtre du Deal Tracker : recherche les sociétés d'après les deals auxquels ils sont liés sur une période donnée. Fin de la période d'opération. Déclencheur du Deal Tracker.
format d/m/Y
incompatible avec fund_focus
no_dealboolSans deal sur la période — Filtre du Deal Tracker : recherche les sociétés d'après les deals auxquels ils sont liés sur une période donnée. Ne renvoie que les sociétés SANS aucun deal sur la période.
valeur attendue : no_deal
incompatible avec fund_focus
op_cible_techboolCible TECH uniquement — Filtre du Deal Tracker : recherche les sociétés d'après les deals auxquels ils sont liés sur une période donnée. Restreint aux deals dont la cible est une entreprise TECH.
valeur attendue : true
incompatible avec fund_focus
acteur_role[]string[]Rôle (acquéreur / cédant / cible) — Filtre du Deal Tracker : recherche les sociétés d'après les deals auxquels ils sont liés sur une période donnée. Rôle(s) dans les deals (acquéreur, cédant, cible, conseil…).
Valeurs : buyer_bloc Acquéreur ou Investisseur · solder_bloc Cédant · society Société cible
incompatible avec fund_focus
op_type[]int[]Type d'opération — Filtre du Deal Tracker : recherche les sociétés d'après les deals auxquels ils sont liés sur une période donnée. Type(s) d'opération des deals recherchés.
Valeurs : 375868 Bourse · 499644 Build-up · 375876 Capital Développement · 375875 Capital Innovation · 375877 Financement · 375871 Infrastructure · 375874 LBO · 375873 M&A Corporate
incompatible avec fund_focus
op_sstype[]int[]Sous-type d'opération — Filtre du Deal Tracker : recherche les sociétés d'après les deals auxquels ils sont liés sur une période donnée. Sous-type(s) d'opération des deals recherchés.
50 valeurs — identifiants : /v1/societe/field-values?field[]=op_sstype
incompatible avec fund_focus
acteur_secteur[]int[]Secteurs d'activités (deals) — Filtre du Deal Tracker : recherche les sociétés d'après les deals auxquels ils sont liés sur une période donnée. Secteur(s) d'activité des deals.
25 valeurs — identifiants : /v1/societe/field-values?field[]=acteur_secteur
incompatible avec fund_focus
CAtrancheDF[]string[]Fourchette montant opération (M€) — Filtre du Deal Tracker : recherche les sociétés d'après les deals auxquels ils sont liés sur une période donnée. Fourchette de montant de l'opération (M€).
Valeurs : 0-5 Entre 0 et 5 · 5-10 Entre 5 et 10 · 10-15 Entre 10 et 15 · 15-20 Entre 15 et 20 · 0-20 Entre 0 et 20 · 20-50 Entre 20 et 50 · 50-150 Entre 50 et 150 · 150-250 Entre 150 et 250 · 250-500 Entre 250 et 500 · 500-1000 Entre 500 et 1000 · >1000 Plus de 1000 · n.d. Non déterminé
incompatible avec fund_focus
VALtranche[]string[]Fourchette valorisation de la cible (en M€) — Filtre du Deal Tracker : recherche les sociétés d'après les deals auxquels ils sont liés sur une période donnée. Fourchette de valorisation de la cible (M€).
Valeurs : 0-5 Entre 0 et 5 · 5-10 Entre 5 et 10 · 10-15 Entre 10 et 15 · 15-20 Entre 15 et 20 · 0-20 Entre 0 et 20 · 20-50 Entre 20 et 50 · 50-150 Entre 50 et 150 · 150-250 Entre 150 et 250 · 250-500 Entre 250 et 500 · 500-1000 Entre 500 et 1000 · >1000 Plus de 1000 · n.d. Non déterminé
incompatible avec fund_focus
ca_interval[]string[]Fourchette CA de la cible (M€) — Filtre du Deal Tracker : recherche les sociétés d'après les deals auxquels ils sont liés sur une période donnée. Fourchette de CA de la cible (M€).
Valeurs : 0-5 Entre 0 et 5 · 5-10 Entre 5 et 10 · 10-15 Entre 10 et 15 · 15-20 Entre 15 et 20 · 0-20 Entre 0 et 20 · 20-50 Entre 20 et 50 · 50-150 Entre 50 et 150 · 150-250 Entre 150 et 250 · 250-500 Entre 250 et 500 · 500-1000 Entre 500 et 1000 · >1000 Plus de 1000 · n.d. Non déterminé
incompatible avec fund_focus
op_keywords_df[]int[]Mots-clés (deals) — Filtre du Deal Tracker : recherche les sociétés d'après les deals auxquels ils sont liés sur une période donnée. Mots-clés des deals.
260 valeurs — identifiants : /v1/societe/field-values?field[]=op_keywords_df
incompatible avec fund_focus
op_region[]int[]Région(s) (de la cible) — Filtre du Deal Tracker : recherche les sociétés d'après les deals auxquels ils sont liés sur une période donnée. Région(s) de la cible des deals.
20 valeurs — identifiants : /v1/societe/field-values?field[]=op_region
incompatible avec fund_focus
display_actor_deal_topboolGénérer un classement (League table) — League Tables : génère un classement des sociétés les plus actives sur la période, classées par nombre de deals correspondant aux filtres du Deal Tracker. Activer avec la valeur `true`. Incompatible avec `no_deal` (un classement sans deal n'a pas de sens).
valeur attendue : true
incompatible avec fund_focus
league_table_limitintTaille du classement (top N) — League Tables : nombre d'entrées du classement (taille du top N). N'a d'effet que si `display_actor_deal_top` est activé. Valeurs autorisées : 5, 10, 20, 40, 50 ; toute autre valeur est ramenée à la valeur autorisée inférieure la plus proche (pas d'erreur). Défaut : 50.
5 valeurs — identifiants : /v1/societe/field-values?field[]=league_table_limit
requiert display_actor_deal_top
incompatible avec fund_focus
fund_focusboolUniquement dans le portefeuille actuel d'un fonds — Fund Focus : ne renvoie que les sociétés actuellement présent(e)s dans le portefeuille d'un fonds / société de gestion. Activer avec la valeur `true`. · valeur attendue : true
keyword_operatorstringOpérateur logique entre mots-clés — Opérateur appliqué entre les mots-clés de `soc_keywords[]`. `OR` (par défaut) : au moins un mot-clé doit matcher. `AND` : tous les mots-clés doivent matcher. · Valeurs : OR OR (par défaut) · AND AND
fund_focus_detention_yearintDurée de détention (années) — Fund Focus : durée de détention en portefeuille ciblée (en années). · requiert fund_focus
fund_focus_detention_year_range-minintDurée de détention min (années) — Fund Focus : durée de détention minimale (fourchette, en années). TOUJOURS À RENSEIGNER AVEC fund_focus_detention_year_range-max — les deux bornes vont par paire, jamais l'une sans l'autre. Pour un minimum ouvert ("plus de X ans"), borner le haut avec la valeur maximale autorisée du champ (ex. min=5 ET max=10). · requiert fund_focus
fund_focus_detention_year_range-maxintDurée de détention max (années) — Fund Focus : durée de détention maximale (fourchette, en années). TOUJOURS À RENSEIGNER AVEC fund_focus_detention_year_range-min — les deux bornes vont par paire, jamais l'une sans l'autre. Pour un maximum ouvert ("moins de X ans"), borner le bas avec la valeur minimale autorisée du champ (ex. min=0 ET max=3). · requiert fund_focus

9.4 — /v1/vehicule · Recherche de véhicules

Fonds et véhicules d'investissement : type juridique, segment, statut, montant levé, société de gestion. 32 filtres typés — liste générée depuis le formulaire de recherche du site.

ParamètreTypeDescription & valeurs
vehicle_nomstringNom
uniqut_citation_articleboolCité dans un article CFNEWS INFRA (envoyer oui)
vehicle_soc_nomstringSociété de gestion
vehicle_investstringInvestisseur du fonds
vehicle_advicestringConseil
vehicle_segment[]int[]Segment · 14 valeurs — identifiants : /v1/vehicule/field-values?field[]=vehicle_segment
CAtranche[]string[]Fourchette de montant levé · Valeurs : 0-20 Entre 0 et 20 · 20-50 Entre 20 et 50 · 50-150 Entre 50 et 150 · 150-250 Entre 150 et 250 · 250-500 Entre 250 et 500 · 500-1000 Entre 500 et 1000 · >1000 Plus de 1000 · n.d. Non déterminé
ticket_tranche[]int[]Fourchette de tickets d'investissement · Valeurs : 375976 0-20 · 375970 1000+ · 375973 150-250 · 375975 20-50 · 375972 250-500 · 375974 50-150 · 375971 500-1000 · 375969 TBD
region[]int[]Région de la société de gestion · 20 valeurs — identifiants : /v1/vehicule/field-values?field[]=region
vehicle_type_invest[]int[]Type d'investissement · Valeurs : 375564 Co-investissement · 375565 Majoritaire · 375566 Minoritaire
vehicle_status[]int[]Statut du fonds · Valeurs : 375568 1er closing · 375578 2nd closing · 375206 3ème closing · 487984 4ème closing · 375584 Closé · 375583 En cours de désinvestissement · 375560 En cours de levée · 509731 Entièrement désinvesti · 375046 Entièrement investi
asset_type[]int[]Type(s) d'actif(s) visé(s) · 15 valeurs — identifiants : /v1/vehicule/field-values?field[]=asset_type
sfdr[]int[]SFDR · Valeurs : 484328 Article 6 · 484327 Article 8 · 484326 Article 9
vehicle_sector[]int[]Secteur d'investissement · 25 valeurs — identifiants : /v1/vehicule/field-values?field[]=vehicle_sector
MontantminnumberMontant levé min
MontantmaxnumberMontant levé max
depuisdateDate de statut (depuis le) · format d/m/Y
jusquaudateDate de statut (jusqu'au) · format d/m/Y
op_date_start_datedateDate d'opération (début) — Filtre du Deal Tracker : recherche les véhicules d'après les deals auxquels ils sont liés sur une période donnée. Début de la période d'opération. Déclencheur du Deal Tracker : les autres filtres deals ne s'appliquent que si une période est renseignée.
format d/m/Y
incompatible avec fund_focus
op_date_end_datedateDate d'opération (fin) — Filtre du Deal Tracker : recherche les véhicules d'après les deals auxquels ils sont liés sur une période donnée. Fin de la période d'opération. Déclencheur du Deal Tracker.
format d/m/Y
incompatible avec fund_focus
no_dealboolSans deal sur la période · valeur attendue : no_deal
op_asset_type[]int[]Type d'actif visés (deals) · 15 valeurs — identifiants : /v1/vehicule/field-values?field[]=op_asset_type
op_type[]int[]Type d'opération — Filtre du Deal Tracker : recherche les véhicules d'après les deals auxquels ils sont liés sur une période donnée. Type(s) d'opération des deals recherchés.
Valeurs : 375868 Bourse · 499644 Build-up · 375876 Capital Développement · 375875 Capital Innovation · 375877 Financement · 375871 Infrastructure · 375874 LBO · 375873 M&A Corporate
incompatible avec fund_focus
op_sstype[]int[]Sous-type d'opération — Filtre du Deal Tracker : recherche les véhicules d'après les deals auxquels ils sont liés sur une période donnée. Sous-type(s) d'opération des deals recherchés.
50 valeurs — identifiants : /v1/vehicule/field-values?field[]=op_sstype
incompatible avec fund_focus
acteur_role[]string[]Rôles (deals) · 72 valeurs
VALtranche[]string[]Fourchette de valorisation (en M€) — Filtre du Deal Tracker : recherche les véhicules d'après les deals auxquels ils sont liés sur une période donnée. Fourchette de valorisation de la cible (M€).
Valeurs : 0-20 Entre 0 et 20 · 20-50 Entre 20 et 50 · 50-150 Entre 50 et 150 · 150-250 Entre 150 et 250 · 250-500 Entre 250 et 500 · 500-1000 Entre 500 et 1000 · >1000 Plus de 1000 · n.d. Non déterminé
incompatible avec fund_focus
ca_interval[]string[]Fourchette de CA de la cible (M€) — Filtre du Deal Tracker : recherche les véhicules d'après les deals auxquels ils sont liés sur une période donnée. Fourchette de CA de la cible (M€).
Valeurs : 0-20 Entre 0 et 20 · 20-50 Entre 20 et 50 · 50-150 Entre 50 et 150 · 150-250 Entre 150 et 250 · 250-500 Entre 250 et 500 · 500-1000 Entre 500 et 1000 · >1000 Plus de 1000 · n.d. Non déterminé
incompatible avec fund_focus
op_keywords_df[]int[]Mots-clés (deals) — Filtre du Deal Tracker : recherche les véhicules d'après les deals auxquels ils sont liés sur une période donnée. Mots-clés des deals.
260 valeurs — identifiants : /v1/vehicule/field-values?field[]=op_keywords_df
incompatible avec fund_focus
op_region[]int[]Région(s) (deals) — Filtre du Deal Tracker : recherche les véhicules d'après les deals auxquels ils sont liés sur une période donnée. Région(s) de la cible des deals.
20 valeurs — identifiants : /v1/vehicule/field-values?field[]=op_region
incompatible avec fund_focus
display_actor_deal_topboolGénérer un classement (League table) — League Tables : génère un classement des véhicules les plus actifs sur la période, classés par nombre de deals correspondant aux filtres du Deal Tracker. Activer avec la valeur `true`.
valeur attendue : Générer un classement
incompatible avec fund_focus
acteur_secteur[]int[]Secteurs d'activités (deals) — Filtre du Deal Tracker : recherche les véhicules d'après les deals auxquels ils sont liés sur une période donnée. Secteur(s) d'activité des deals.
25 valeurs — identifiants : /v1/vehicule/field-values?field[]=acteur_secteur
incompatible avec fund_focus
CAtrancheDF[]string[]Fourchette montant opération (M€) — Filtre du Deal Tracker : recherche les véhicules d'après les deals auxquels ils sont liés sur une période donnée. Fourchette de montant de l'opération (M€).
Valeurs : 0-5 Entre 0 et 5 · 5-10 Entre 5 et 10 · 10-15 Entre 10 et 15 · 15-20 Entre 15 et 20 · 0-20 Entre 0 et 20 · 20-50 Entre 20 et 50 · 50-150 Entre 50 et 150 · 150-250 Entre 150 et 250 · 250-500 Entre 250 et 500 · 500-1000 Entre 500 et 1000 · >1000 Plus de 1000 · n.d. Non déterminé
incompatible avec fund_focus
league_table_limitintTaille du classement (top N) — League Tables : nombre d'entrées du classement (taille du top N). N'a d'effet que si `display_actor_deal_top` est activé. Valeurs autorisées : 5, 10, 20, 40, 50 ; toute autre valeur est ramenée à la valeur autorisée inférieure la plus proche (pas d'erreur). Défaut : 50.
5 valeurs — identifiants : /v1/vehicule/field-values?field[]=league_table_limit
requiert display_actor_deal_top
incompatible avec fund_focus

9.5 — /v1/mouvement · Mouvements & nominations

Nominations, recrutements et changements de poste. 18 filtres typés — liste générée depuis le formulaire de recherche du site.

ParamètreTypeDescription & valeurs
mvt_nomstringPersonnalité (nom)
mvt_categoryintCatégorie · Valeurs : 375347 Conseil financier · 375349 Conseil juridique · 375348 Investisseurs · 375346 Société
mvt_nationalitystringNationalité (de la nouvelle organisation) · 250 valeurs
mvt_dureeminnumberAncienneté (en mois) Min
mvt_dureemaxnumberAncienneté (en mois) Max
mvt_new_orgastringNouvelle organisation
mvt_ssdomaine[]int[]Domaine d'activité ou expertise · 60 valeurs — identifiants : /v1/mouvement/field-values?field[]=mvt_ssdomaine
regionintRégion de la nouvelle organisation · 20 valeurs — identifiants : /v1/mouvement/field-values?field[]=region
mvt_sector[]int[]Secteurs d'activités (nouvelle organisation) — Recherche les acteurs ayant les secteurs sélectionnés · 25 valeurs — identifiants : /v1/mouvement/field-values?field[]=mvt_sector
mvt_old_orgastringAncienne organisation
depuisdateDate mouvement - entre le · format d/m/Y
jusquaudateDate mouvement - et le · format d/m/Y
depuis_creationdateDate de création ANALYSTE - début · format d/m/Y
jusquau_creationdateDate de création ANALYSTE - fin · format d/m/Y
depuis_majdateDate de mise à jour ANALYSTE - début · format d/m/Y
jusquau_majdateDate de mise à jour ANALYSTE - fin · format d/m/Y
silent_moveboolPersonnalités en silent move (non rattachées) · valeur attendue : true
silent_move_periodintPériode (silent move) · Valeurs : 7 7 jours · 15 15 jours · 28 28 jours · 30 1 mois · 60 2 mois · 90 3 mois

9.6 — /v1/people · Annuaire des personnalités

Dirigeants, associés et professionnels de l'infrastructure et du financement. 34 filtres typés — liste générée depuis le formulaire de recherche du site.

ParamètreTypeDescription & valeurs
people_nomstringNom (Prénom)
people_domaineintDomaine · Valeurs : 368371 Avocats · 368535 Banquiers · 368558 Conseils · 368353 Fonds d'investissement · 368594 Sociétés
people_practiceintPractice · 94 valeurs — identifiants : /v1/people/field-values?field[]=people_practice
people_region[]int[]Région (organisation) · 20 valeurs — identifiants : /v1/people/field-values?field[]=people_region
people_dpt[]string[]Département (organisation) · 101 valeurs
people_zone[]string[]Nationalité (organisation) · 250 valeurs
people_titres[]int[]Titre / Fonction — Recherche les personnalités ayant les titres sélectionnés · 273 valeurs — identifiants : /v1/people/field-values?field[]=people_titres
people_societestringOrganisation
people_type_organisation[]int[]Type d'organisation · Valeurs : 375347 Conseil financier · 375349 Conseil juridique · 375348 Investisseurs · 375346 Société
people_sous_domaine[]int[]Sous-domaine de l'organisation · Valeurs : {'Asset Management': 376001, "Assistance à Maîtrise d'Ouvrage": 376007, 'Association': 376031, 'Audit technique': 375997, 'Capital Développement': 376013, 'Capital Risque': 375990, 'Commercialisation': 376005, 'Conseil aux utilisateurs': 376006, 'Conseil financement': 376022, 'Conseil investissement': 376028, 'Conseil transactions immobilières': 376021, 'Corporate': 376027, 'Due Diligence Assurance': 376025, 'Due Diligence Environnement': 376015, 'Due Diligence Financière': 376024, 'Due Diligence RH': 376023, 'ESG': 483065, 'Evaluation': 492263, 'Family Office': 375991, 'Financement/Dette': 375994, 'Gestion privée': 375993, 'Infrastructure': 375982, 'Investment banking': 376060, 'IPOs': 376020, 'LBO': 375981} Conseil financier · {'Administrateur judiciaire': 375965, 'Association': 376031, "Cabinet d'avocats": 375998, 'Capital Développement': 376013, 'Etude notariale': 376052, 'Financement/Dette': 375994, 'Management package': 501211, 'Réseau': 376053} Conseil juridique · {'Amorçage': 376038, 'Capital Développement': 376013, 'Capital Risque': 375990, 'Co-investissement': 376012, 'Dette': 376000, 'Fonds de dette / Fonds obligataire': 375987, 'Fonds de Fonds': 375986, 'Généraliste': 375984, 'Immobilier': 375983, 'Infrastructure': 375982, 'LBO': 375981, 'Mezzanine': 375980, 'PIPE': 375979, 'PPP': 375977, 'Retournement / Situations spéciales': 375968, 'Secondaire': 375985} Investisseurs · {'Cotée': 375967, 'Familiale': 376014, 'Filiale Groupe': 376035, 'Indépendante': 376034, 'Sté en LBO': 376033, 'Sté en redressement': 506506, 'Sté liquidée': 376032} Société
uniqut_avec_liboolUniquement avec un linkedIN renseigné · valeur attendue : oui
op_date_start_datedateDate d'opération - Début — Filtre du Deal Tracker : recherche les personnalités d'après les deals auxquels ils sont liés sur une période donnée. Début de la période d'opération. Déclencheur du Deal Tracker : les autres filtres deals ne s'appliquent que si une période est renseignée.
format d/m/Y
incompatible avec fund_focus
op_date_end_datedateDate d'opération - Fin — Filtre du Deal Tracker : recherche les personnalités d'après les deals auxquels ils sont liés sur une période donnée. Fin de la période d'opération. Déclencheur du Deal Tracker.
format d/m/Y
incompatible avec fund_focus
op_asset_type[]int[]Type d'actif visés · 15 valeurs — identifiants : /v1/people/field-values?field[]=op_asset_type
op_type[]int[]Type d'opération — Filtre du Deal Tracker : recherche les personnalités d'après les deals auxquels ils sont liés sur une période donnée. Type(s) d'opération des deals recherchés.
Valeurs : 375868 Bourse · 499644 Build-up · 375876 Capital Développement · 375875 Capital Innovation · 375877 Financement · 375871 Infrastructure · 375874 LBO · 375873 M&A Corporate
incompatible avec fund_focus
op_sstype[]int[]Sous-type d'opération — Filtre du Deal Tracker : recherche les personnalités d'après les deals auxquels ils sont liés sur une période donnée. Sous-type(s) d'opération des deals recherchés.
50 valeurs — identifiants : /v1/people/field-values?field[]=op_sstype
incompatible avec fund_focus
CAtranche[]string[]Fourchette de montant (M€) · Valeurs : 0-20 Entre 0 et 20 · 20-50 Entre 20 et 50 · 50-150 Entre 50 et 150 · 150-250 Entre 150 et 250 · 250-500 Entre 250 et 500 · 500-1000 Entre 500 et 1000 · >1000 Plus de 1000
people_role[]string[]Rôles (deals) — Filtre du Deal Tracker : recherche les personnalités d'après les deals auxquels ils sont liés sur une période donnée. Rôle(s) dans les deals (acquéreur, cédant, cible, conseil…).
74 valeurs
incompatible avec fund_focus
VALtranche[]string[]Fourchette de valorisation (en M€) — Filtre du Deal Tracker : recherche les personnalités d'après les deals auxquels ils sont liés sur une période donnée. Fourchette de valorisation de la cible (M€).
Valeurs : 0-20 Entre 0 et 20 · 20-50 Entre 20 et 50 · 50-150 Entre 50 et 150 · 150-250 Entre 150 et 250 · 250-500 Entre 250 et 500 · 500-1000 Entre 500 et 1000 · >1000 Plus de 1000
incompatible avec fund_focus
ca_interval[]string[]Fourchette de CA de la cible (M€) — Filtre du Deal Tracker : recherche les personnalités d'après les deals auxquels ils sont liés sur une période donnée. Fourchette de CA de la cible (M€).
Valeurs : 0-20 Entre 0 et 20 · 20-50 Entre 20 et 50 · 50-150 Entre 50 et 150 · 150-250 Entre 150 et 250 · 250-500 Entre 250 et 500 · 500-1000 Entre 500 et 1000 · >1000 Plus de 1000
incompatible avec fund_focus
op_keywords_df[]int[]Mots-clés (deals) — Filtre du Deal Tracker : recherche les personnalités d'après les deals auxquels ils sont liés sur une période donnée. Mots-clés des deals.
260 valeurs — identifiants : /v1/people/field-values?field[]=op_keywords_df
incompatible avec fund_focus
op_region[]int[]Région(s) — Filtre du Deal Tracker : recherche les personnalités d'après les deals auxquels ils sont liés sur une période donnée. Région(s) de la cible des deals.
20 valeurs — identifiants : /v1/people/field-values?field[]=op_region
incompatible avec fund_focus
display_actor_deal_topboolGénérer un classement (League table) — League Tables : génère un classement des personnalités les plus actives sur la période, classées par nombre de deals correspondant aux filtres du Deal Tracker. Activer avec la valeur `true`.
valeur attendue : Générer un classement
incompatible avec fund_focus
people_secteur[]int[]Secteurs d'activités (deals) — Filtre du Deal Tracker : recherche les personnalités d'après les deals auxquels ils sont liés sur une période donnée. Secteur(s) d'activité des deals.
25 valeurs — identifiants : /v1/people/field-values?field[]=people_secteur
incompatible avec fund_focus
op_descstringDescriptif d'activité (deals) — Filtre du Deal Tracker : recherche les personnalités d'après les deals auxquels ils sont liés sur une période donnée. Mots recherchés dans le descriptif d'activité des deals. · incompatible avec fund_focus
op_cible_techboolCible TECH uniquement — Filtre du Deal Tracker : recherche les personnalités d'après les deals auxquels ils sont liés sur une période donnée. Restreint aux deals dont la cible est une entreprise TECH.
valeur attendue : true
incompatible avec fund_focus
minoritaireboolFond minoritaire — Filtre du Deal Tracker : recherche les personnalités d'après les deals auxquels ils sont liés sur une période donnée. Restreint aux deals où le fonds est minoritaire. · incompatible avec fund_focus
majoritaireboolFond majoritaire — Filtre du Deal Tracker : recherche les personnalités d'après les deals auxquels ils sont liés sur une période donnée. Restreint aux deals où le fonds est majoritaire. · incompatible avec fund_focus
CAtrancheDF[]string[]Fourchette montant opération (M€) — Filtre du Deal Tracker : recherche les personnalités d'après les deals auxquels ils sont liés sur une période donnée. Fourchette de montant de l'opération (M€).
Valeurs : 0-5 Entre 0 et 5 · 5-10 Entre 5 et 10 · 10-15 Entre 10 et 15 · 15-20 Entre 15 et 20 · 0-20 Entre 0 et 20 · 20-50 Entre 20 et 50 · 50-150 Entre 50 et 150 · 150-250 Entre 150 et 250 · 250-500 Entre 250 et 500 · 500-1000 Entre 500 et 1000 · >1000 Plus de 1000 · n.d. Non déterminé
incompatible avec fund_focus
league_table_limitintTaille du classement (top N) — League Tables : nombre d'entrées du classement (taille du top N). N'a d'effet que si `display_actor_deal_top` est activé. Valeurs autorisées : 5, 10, 20, 40, 50 ; toute autre valeur est ramenée à la valeur autorisée inférieure la plus proche (pas d'erreur). Défaut : 50.
5 valeurs — identifiants : /v1/people/field-values?field[]=league_table_limit
requiert display_actor_deal_top
incompatible avec fund_focus
fund_focusboolUniquement dans le portefeuille actuel d'un fonds — Fund Focus : ne renvoie que les personnalités actuellement présent(e)s dans le portefeuille d'un fonds / société de gestion. Activer avec la valeur `true`. · valeur attendue : true
fund_focus_detention_yearintDurée de détention (années) — Fund Focus : durée de détention en portefeuille ciblée (en années). · requiert fund_focus
fund_focus_detention_year_range-minintDurée de détention min (années) — Fund Focus : durée de détention minimale (fourchette, en années). TOUJOURS À RENSEIGNER AVEC fund_focus_detention_year_range-max — les deux bornes vont par paire, jamais l'une sans l'autre. Pour un minimum ouvert ("plus de X ans"), borner le haut avec la valeur maximale autorisée du champ (ex. min=5 ET max=10). · requiert fund_focus
fund_focus_detention_year_range-maxintDurée de détention max (années) — Fund Focus : durée de détention maximale (fourchette, en années). TOUJOURS À RENSEIGNER AVEC fund_focus_detention_year_range-min — les deux bornes vont par paire, jamais l'une sans l'autre. Pour un maximum ouvert ("moins de X ans"), borner le bas avec la valeur minimale autorisée du champ (ex. min=0 ET max=3). · requiert fund_focus

9.7 — /v1/actualite · Articles

ParamètreTypeDescription
titlestring[]Mots dans le titre (séparés par ;, à encoder %3B dans une URL)
intro_fullstring[]Mots dans le chapeau (séparés par ;, à encoder %3B dans une URL)
sector[]string[]Secteurs
theme[]string[]Thèmes / opérations (cf. menu cfnewsinfra.net)
region[]string[]Régions
place[]string[]Zones géographiques
keyword[] / tag[]string[]Mots-clés / tags
related-actor[] / related-society[]string[]Articles liés à un acteur / une société
date_start / date_enddateFormat Y-m-d (différent du reste : ex. 2025-07-13)
date_betweenstring[]Plage(s) Y-m-d;Y-m-d (le ; doit être encodé %3B dans une URL)
sort / sort_directionenumTri par publication_date ou modification_date · asc/desc
Attention au format de date. L'endpoint /v1/actualite utilise Y-m-d (ex. 2025-12-31), alors que tous les autres endpoints (/v1/operation, /v1/vehicule, /v1/mouvement…) utilisent d/m/Y (ex. 31/12/2025).

9.8 — /v1/actif · Actifs d'infrastructure

Actifs d'infrastructure (data centers, transports, énergies renouvelables, télécoms…). 5 filtres typés — liste générée depuis le formulaire de recherche du site.

ParamètreTypeDescription & valeurs
asset_namestringNom de l'actif
asset_region[]int[]Région (France) · 20 valeurs — identifiants : /v1/actif/field-values?field[]=asset_region
asset_type[]int[]Type d'actif · 15 valeurs — identifiants : /v1/actif/field-values?field[]=asset_type
asset_ca_interval[]string[]Fourchette de CA · Valeurs : 0-20 Entre 0 et 20 · 20-50 Entre 20 et 50 · 50-150 Entre 50 et 150 · 150-250 Entre 150 et 250 · 250-500 Entre 250 et 500 · 500-1000 Entre 500 et 1000 · >1000 Plus de 1000
asset_nationality[]string[]Nationalité · 250 valeurs

Récupérer les listes de valeurs dynamiquement

Pour chaque type de fiche, un endpoint field-values permet de récupérer dynamiquement la liste des valeurs autorisées pour un champ donné. Idéal pour alimenter un formulaire ou un dropdown sans coder en dur les IDs :

EndpointExemple
/v1/operation/field-values?field[]=op_type&field[]=sector&field[]=op_keywords
/v1/vehicule/field-values?field[]=vehicle_segment&field[]=vehicle_type&field[]=sfdr
/v1/acteur/field-values?field[]=acteur_domaine&field[]=acteur_sous_domaine
/v1/societe/field-values?field[]=soc_activity&field[]=sector
/v1/mouvement/field-values?field[]=mvt_type_organisation&field[]=region
/v1/people/field-values?field[]=people_titres&field[]=people_type_organisation
/v1/actif/field-values?field[]=asset_type&field[]=asset_region
/v1/actualite/field-values?field[]=theme&field[]=sector

10 Exemples par endpoint

Avant d'écrire une ligne de code, nous vous recommandons d'explorer l'API depuis la console Swagger interactive sur api.cfnewsinfra.net/doc. Vous y validez vos requêtes (paramètres, valeurs enum, combinaisons de filtres) avant de les transposer dans votre langage de prédilection.

10.1 — Cas d'usage par endpoint

Les exemples ci-dessous illustrent des questions métier réelles avec leur traduction en requête HTTP. Pour chaque cas, le pattern Python requests équivalent suit directement.

A. /v1/operation — Recherche de deals

(1) « Opérations d'infrastructure sur des data centers depuis 2025 »

# curl
curl "https://api.cfnewsinfra.net/v1/operation?op_type[]=375871&asset_type[]=489738&depuis=01/01/2025" \
  -H "Authorization: Bearer $TOKEN"

# Python
params = {
    "op_type[]": [375871],  # Infrastructure
    "asset_type[]": [489738],  # Data center
    "depuis": "01/01/2025",
}
r = requests.get(f"{API_BASE}/operation", headers=headers, params=params).json()

(2) « LBO en France depuis 2025 »

# curl
curl "https://api.cfnewsinfra.net/v1/operation?op_type[]=375874&op_nationality[]=FR&depuis=01/01/2025&jusquau=31/12/2025" \
  -H "Authorization: Bearer $TOKEN"

# Python
params = {
    "op_type[]": [375874],  # LBO
    "op_nationality[]": ["FR"],
    "depuis": "01/01/2025",
    "jusquau": "31/12/2025",
}
r = requests.get(f"{API_BASE}/operation", headers=headers, params=params).json()

(3) « Toutes les opérations d'un investisseur (acquéreur ou cédant) »

# curl
curl "https://api.cfnewsinfra.net/v1/operation?op_invest=ARDIAN&depuis=01/01/2024" \
  -H "Authorization: Bearer $TOKEN"

# Python
params = {
    "op_invest": "ARDIAN",
    "depuis": "01/01/2024",
}
r = requests.get(f"{API_BASE}/operation", headers=headers, params=params).json()

(4) « Opérations sur lesquelles un cabinet est intervenu comme conseil (recherche par nom) »

# curl
curl "https://api.cfnewsinfra.net/v1/operation?op_conseil=Gide&depuis=01/01/2024" \
  -H "Authorization: Bearer $TOKEN"

# Python
params = {
    "op_conseil": "Gide",
    "depuis": "01/01/2024",
}
r = requests.get(f"{API_BASE}/operation", headers=headers, params=params).json()

(5) « Financements en Île-de-France, CA de la cible entre 50 et 150 M€ »

# curl
curl "https://api.cfnewsinfra.net/v1/operation?op_type[]=375877&region[]=375252&ca_interval[]=50-150" \
  -H "Authorization: Bearer $TOKEN"

# Python
params = {
    "op_type[]": [375877],  # Financement
    "region[]": [375252],  # Île-de-France
    "ca_interval[]": ["50-150"],
}
r = requests.get(f"{API_BASE}/operation", headers=headers, params=params).json()

(6) « Énergies renouvelables : solaire ET éolien (mots-clés AND) »

# curl
curl "https://api.cfnewsinfra.net/v1/operation?op_keywords[]=375359&op_keywords[]=375367&keyword_operator=AND&depuis=01/01/2024" \
  -H "Authorization: Bearer $TOKEN"

# Python
params = {
    "op_keywords[]": [375359, 375367],  # solaire, éolien
    "keyword_operator": "AND",
    "depuis": "01/01/2024",
}
r = requests.get(f"{API_BASE}/operation", headers=headers, params=params).json()

B. /v1/vehicule — Véhicules d'investissement

(1) « Véhicules Infrastructure de l'Article 8 en cours de levée »

# curl
curl "https://api.cfnewsinfra.net/v1/vehicule?vehicle_segment[]=375567&sfdr[]=484327&vehicle_status[]=375560" \
  -H "Authorization: Bearer $TOKEN"

# Python
params = {
    "vehicle_segment[]": [375567],  # Infrastructure
    "sfdr[]": [484327],  # Article 8
    "vehicle_status[]": [375560],  # En cours de levée
}
r = requests.get(f"{API_BASE}/vehicule", headers=headers, params=params).json()

(2) « Véhicules du segment Infrastructure »

# curl
curl "https://api.cfnewsinfra.net/v1/vehicule?vehicle_segment[]=375567" \
  -H "Authorization: Bearer $TOKEN"

# Python
params = {
    "vehicle_segment[]": [375567],  # Infrastructure
}
r = requests.get(f"{API_BASE}/vehicule", headers=headers, params=params).json()

C. /v1/acteur — Annuaire des acteurs

(1) « Investisseurs français »

# curl
curl "https://api.cfnewsinfra.net/v1/acteur?acteur_domaine[]=448197&acteur_zone[]=FR" \
  -H "Authorization: Bearer $TOKEN"

# Python
params = {
    "acteur_domaine[]": [448197],  # Investisseurs
    "acteur_zone[]": ["FR"],
}
r = requests.get(f"{API_BASE}/acteur", headers=headers, params=params).json()

(2) « Cabinets d'avocats présents à Paris »

# curl
curl "https://api.cfnewsinfra.net/v1/acteur?acteur_domaine[]=448198&acteur_dpt[]=75" \
  -H "Authorization: Bearer $TOKEN"

# Python
params = {
    "acteur_domaine[]": [448198],  # Conseil juridique
    "acteur_dpt[]": ["75"],
}
r = requests.get(f"{API_BASE}/acteur", headers=headers, params=params).json()

D. /v1/societe — Recherche de sociétés

(1) « Sociétés en LBO du secteur Énergie, CA entre 50 et 150 M€ »

# curl
curl "https://api.cfnewsinfra.net/v1/societe?soc_activity[]=376033&sector[]=375298&soc_ca_interval[]=50-150" \
  -H "Authorization: Bearer $TOKEN"

# Python
params = {
    "soc_activity[]": [376033],  # Sté en LBO
    "sector[]": [375298],  # Energie & Utilities
    "soc_ca_interval[]": ["50-150"],
}
r = requests.get(f"{API_BASE}/societe", headers=headers, params=params).json()

(2) « Sociétés cotées en Île-de-France »

# curl
curl "https://api.cfnewsinfra.net/v1/societe?soc_activity[]=375967&soc_region[]=375252" \
  -H "Authorization: Bearer $TOKEN"

# Python
params = {
    "soc_activity[]": [375967],  # Cotée
    "soc_region[]": [375252],  # Île-de-France
}
r = requests.get(f"{API_BASE}/societe", headers=headers, params=params).json()

E. /v1/mouvement — Nominations

(1) « Mouvements 2025 chez les investisseurs »

# curl
curl "https://api.cfnewsinfra.net/v1/mouvement?mvt_category=375348&depuis=01/01/2025&jusquau=31/12/2025" \
  -H "Authorization: Bearer $TOKEN"

# Python
params = {
    "mvt_category": 375348,  # Investisseurs
    "depuis": "01/01/2025",
    "jusquau": "31/12/2025",
}
r = requests.get(f"{API_BASE}/mouvement", headers=headers, params=params).json()

(2) « Mouvements en provenance d'une organisation (départs) »

# curl
curl "https://api.cfnewsinfra.net/v1/mouvement?mvt_old_orga=Ardian" \
  -H "Authorization: Bearer $TOKEN"

# Python
params = {
    "mvt_old_orga": "Ardian",
}
r = requests.get(f"{API_BASE}/mouvement", headers=headers, params=params).json()

F. /v1/people — Annuaire des personnalités

(1) « Partners d'investisseurs »

# curl
curl "https://api.cfnewsinfra.net/v1/people?people_type_organisation[]=375348&people_titres[]=375766" \
  -H "Authorization: Bearer $TOKEN"

# Python
params = {
    "people_type_organisation[]": [375348],  # Investisseurs
    "people_titres[]": [375766],  # Partner
}
r = requests.get(f"{API_BASE}/people", headers=headers, params=params).json()

G. /v1/actualite — Articles

(1) « Articles 2026 sur les data centers, du plus récent au plus ancien »

# curl
curl "https://api.cfnewsinfra.net/v1/actualite?title=data%3Bcenter&date_start=2026-01-01&sort=publication_date&sort_direction=desc" \
  -H "Authorization: Bearer $TOKEN"

# Python
params = {
    "title": "data;center",  # les deux mots, séparés par ;
    "date_start": "2026-01-01",
    "sort": "publication_date",
    "sort_direction": "desc",
}
r = requests.get(f"{API_BASE}/actualite", headers=headers, params=params).json()

(2) « Articles liés à un acteur précis (identifiant de l'acteur) »

# curl
curl "https://api.cfnewsinfra.net/v1/actualite?related-actor[]=455858" \
  -H "Authorization: Bearer $TOKEN"

# Python
params = {
    "related-actor[]": ["455858"],
}
r = requests.get(f"{API_BASE}/actualite", headers=headers, params=params).json()

H. /v1/acteur/portfolio_now/{id} — Portefeuille actuel

(1) « Portefeuille actuel complet de l'acteur 455858 (XANGE), toutes pages »

all_ops = []
page = 1
while True:
    r = requests.get(f"{API_BASE}/acteur/portfolio_now/455858",
                     headers=headers, params={"page": page}).json()
    all_ops.extend(r["items"])
    if page >= r["nb_pages"]: break
    page += 1
# autant d'items/page que votre abonnement — boucler jusqu'à nb_pages

(2) « Compter sans consommer le portefeuille de sortie »

r = requests.get(f"{API_BASE}/acteur/portfolio_sortie/455858",
                 headers=headers, params={"ping": "true"}).json()
print("Sorties :", r["total"])

I. /v1/actif — Actifs d'infrastructure

(1) « Data centers en Île-de-France »

# curl
curl "https://api.cfnewsinfra.net/v1/actif?asset_type[]=489738&asset_region[]=375252" \
  -H "Authorization: Bearer $TOKEN"

# Python
params = {
    "asset_type[]": [489738],  # Data center
    "asset_region[]": [375252],  # Île-de-France
}
r = requests.get(f"{API_BASE}/actif", headers=headers, params=params).json()

(2) « Actifs d'énergies renouvelables en France, CA entre 0 et 20 M€ »

# curl
curl "https://api.cfnewsinfra.net/v1/actif?asset_type[]=375033&asset_nationality[]=FR&asset_ca_interval[]=0-20" \
  -H "Authorization: Bearer $TOKEN"

# Python
params = {
    "asset_type[]": [375033],  # Energies renouvelables
    "asset_nationality[]": ["FR"],
    "asset_ca_interval[]": ["0-20"],
}
r = requests.get(f"{API_BASE}/actif", headers=headers, params=params).json()

10.2 — Exemples génériques

Exemples — curl

Rechercher les LBO du secteur Logiciel en 2025

# Utiliser les filtres typés issus de la spécification
curl -X GET \
  "https://api.cfnewsinfra.net/v1/operation?op_type[]=375874&sector[]=375332&depuis=01/01/2025&jusquau=31/12/2025" \
  -H "Authorization: Bearer VOTRE_TOKEN" \
  -H "Accept: application/json"

Estimer le volume sans consommer de quota

# Ajouter ping=true
curl -X GET \
  "https://api.cfnewsinfra.net/v1/operation?op_type[]=375873&ping=true" \
  -H "Authorization: Bearer VOTRE_TOKEN"

# Réponse :
{ "total": 791, "quota": { "request_cost": 0, ... } }

Exemples — Python (requests)

Recherche de deals avec filtres typés

import requests

API_BASE = "https://api.cfnewsinfra.net/v1"
TOKEN    = "VOTRE_TOKEN"

headers = {
    "Authorization": f"Bearer {TOKEN}",
    "Accept": "application/json",
}

# IMPORTANT : pour les filtres typés [], passer une liste à `params`.
# requests sérialise automatiquement en op_type[]=375874&op_type[]=375873
params = {
    "op_type[]":  [375874, 375873],      # LBO + M&A Corporate
    "sector[]":   [375332],            # Logiciel et services informatiques
    "region[]":   [375252],            # Île-de-France
    "depuis":     "01/01/2025",       # format d/m/Y
    "jusquau":    "31/12/2025",
    "page":       1,
}

resp = requests.get(f"{API_BASE}/operation", headers=headers, params=params)
resp.raise_for_status()
data = resp.json()

print(f"Total deals : {data['total']}")
print(f"Quota utilisé ce mois : {data['quota']['monthly_used']} / {data['quota']['monthly_limit']}")

for deal in data["items"]:
    print(deal["metadata"]["id"], "-", deal["metadata"]["name"])

Compter sans consommer (ping=true)

def count_deals(op_type_ids, year):
    """Retourne le nombre total de deals correspondants — coût quota : 0"""
    params = {
        "op_type[]": op_type_ids,
        "depuis":    f"01/01/{year}",
        "jusquau":   f"31/12/{year}",
        "ping":      "true",
    }
    r = requests.get(f"{API_BASE}/operation", headers=headers, params=params)
    r.raise_for_status()
    return r.json()["total"]

# Estimation rapide pour dimensionner une recherche
nb_lbo  = count_deals([375874], 2025)
nb_buildup = count_deals([499644], 2025)
print(f"LBO 2025 : {nb_lbo} | Build-ups 2025 : {nb_buildup}")

Récupérer un portefeuille complet (pagination selon l'abonnement)

def get_full_portfolio(acteur_id):
    """Boucle sur toutes les pages d'un portefeuille acteur (items/page selon l'abonnement)."""
    all_ops = []
    page    = 1
    url     = f"{API_BASE}/acteur/portfolio_now/{acteur_id}"

    while True:
        r = requests.get(url, headers=headers, params={"page": page})
        r.raise_for_status()
        data = r.json()
        all_ops.extend(data["items"])

        if page >= data["nb_pages"]:
            break
        page += 1

    return all_ops

# Exemple : portefeuille actuel de l'acteur d'ID 455858
portfolio = get_full_portfolio(455858)
print(f"{len(portfolio)} sociétés en portefeuille")

Récupérer les valeurs autorisées d'un champ (field-values)

# Récupérer dynamiquement les types d'opération disponibles
# (idéal pour alimenter un dropdown côté front)
r = requests.get(
    f"{API_BASE}/operation/field-values",
    headers=headers,
    params={"field[]": ["op_type", "sector"]},
)
r.raise_for_status()
fields = r.json()["fields"]

for field_name, values in fields.items():
    print(f"--- {field_name} ---")
    for label, value_id in list(values.items())[:5]:
        print(f"  {label} = {value_id}")

Gestion des erreurs (429, 422, 403)

import time
from requests.exceptions import HTTPError

def safe_get(url, params=None, max_retries=3):
    """GET avec backoff exponentiel sur 429 et gestion des erreurs métier."""
    for attempt in range(max_retries):
        r = requests.get(url, headers=headers, params=params)

        if r.status_code == 200:
            return r.json()

        if r.status_code == 429:                # too_many_requests
            wait = 2 ** attempt
            print(f"Rate limit, attente {wait}s...")
            time.sleep(wait)
            continue

        if r.status_code == 422:                # too_broad_search
            raise ValueError("Recherche trop large, ajoutez des filtres")

        if r.status_code == 403:                # forbidden / limit_exceeded
            err = r.json()
            raise PermissionError(err.get("error", "Accès refusé"))

        r.raise_for_status()

    raise RuntimeError("Échec après plusieurs tentatives")

Exemples — Python (SDK généré)

Pour les intégrations plus structurées, nous recommandons de générer un SDK Python typé à partir de doc.json. Le SDK gère automatiquement l'authentification, la sérialisation des filtres et les modèles de données.

# 1. Installation du générateur
pip install openapi-python-client

# 2. Génération du SDK depuis la spécification
openapi-python-client generate \
  --url https://api.cfnewsinfra.net/doc.json \
  --meta poetry

# 3. Utilisation (le client est dans ./cfnews-api-client/)
from cfnews_api_client import AuthenticatedClient
from cfnews_api_client.api.referentiel import get_api_referentiels_get_deals

client = AuthenticatedClient(
    base_url="https://api.cfnewsinfra.net",
    token="VOTRE_TOKEN",
)

# Recherche typée — autocomplétion IDE et validation à la compilation
response = get_api_referentiels_get_deals.sync(
    client=client,
    op_type=[375874, 375873],
    sector=[375332],
    depuis="01/01/2025",
    jusquau="31/12/2025",
)

print(f"Trouvé {response.total} deals")

Exemples — JavaScript / TypeScript

Récupération paginée avec fetch

async function getFullPortfolio(acteurId, token) {
  const all = [];
  let page = 1;
  while (true) {
    const res = await fetch(
      `https://api.cfnewsinfra.net/v1/acteur/portfolio_now/${acteurId}?page=${page}`,
      { headers: { Authorization: `Bearer ${token}` } }
    );
    const data = await res.json();
    all.push(...data.items);
    if (page >= data.nb_pages) break;
    page++;
  }
  return all;
}

Génération d'un SDK TypeScript

# 1. Récupération de la spec
curl -o cfnews-openapi.json https://api.cfnewsinfra.net/doc.json

# 2. Génération d'un client TypeScript
npx @openapitools/openapi-generator-cli generate \
  -i cfnews-openapi.json \
  -g typescript-axios \
  -o ./cfnews-sdk

# Le SDK généré gère automatiquement :
# - les types stricts (op_type, sector, region…)
# - l'authentification Bearer
# - la sérialisation des tableaux (op_type[]=375874&op_type[]=375873)
Sérialisation des tableaux. Les paramètres typés enum en tableau (suffixe []) doivent être envoyés sous forme de paramètres répétés : ?op_type[]=375874&op_type[]=375873 (et non op_type=271,272). Les SDK générés et la plupart des clients HTTP (requests en Python, axios, …) s'en chargent automatiquement quand on passe une liste.
Astuce — copier les requêtes depuis Swagger. Sur api.cfnewsinfra.net/doc, après avoir exécuté une requête via « Try it out », Swagger affiche la commande curl équivalente. Vous pouvez la copier puis la convertir en Python requests via curlconverter.com ou directement dans votre IDE.

11 Que faire de doc.json ?

La spécification OpenAPI CFNEWS INFRA est conçue pour être opérationnelle : elle alimente directement vos outils de développement, de documentation et d'intégration.

— LE PLUS SIMPLE

Console Swagger interactive

Testez tous les endpoints en direct sans écrire une ligne de code, depuis api.cfnewsinfra.net/doc.

Ouvrir la console →
— 01

Génération de clients

SDK auto-générés en Python, TypeScript, Java, PHP, C#… via openapi-generator. Types stricts garantis.

— 02

Documentation embarquée

Rendu visuel via Redoc ou Stoplight pour intégrer la doc dans votre portail interne.

— 03

Test & exploration

Import direct dans Postman, Insomnia ou Bruno. Collections prêtes à l'emploi.

— 04

Validation contractuelle

Validation des requêtes et réponses côté serveur ou client via les schémas OpenAPI. Détection précoce des dérives.

— 05

Intégration IA / MCP

Consommation par des agents LLM (Claude, GPT…) via le serveur CFNEWS INFRA MCP, ou dans vos pipelines RAG.

Prêt à intégrer l'API CFNEWS INFRA ?

Pour toute question sur l'intégration — génération de clients, intégration MCP, authentification, dimensionnement du quota — l'équipe technique CFNEWS INFRA se tient à votre disposition.