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.
api.cfnewsinfra.net/doc
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.
doc.json. C'est une spécification vivante, versionnée, sur laquelle
vos intégrations peuvent s'appuyer.
api.cfnewsinfra.net/docLe
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.
Dictionnaire des entités
| Entité | Description métier | Schéma OpenAPI |
|---|---|---|
| Opération | Deal (Infrastructure, LBO, M&A Corporate, Build-up, Capital Développement, Capital Innovation, Financement, Bourse). | Operation |
| Acteur | Fonds 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éhicule | Fonds 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 |
| Mouvement | Nominations, recrutements et changements de poste dans l'industrie. | Mouvement |
| Actif | Actifs 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
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.
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) oudesc(descendant, par défaut sur la plupart des endpoints). - pingboolean
- Si
true, retourne uniquementtotalsans 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).
/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écialeEU= 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.
Valeurs possibles pour les champs des opérations.
Valeurs possibles pour les champs des acteurs.
Valeurs possibles pour les champs des sociétés.
Valeurs possibles pour les champs des véhicules.
Valeurs possibles pour les champs des personnalités.
Valeurs possibles pour les champs des mouvements.
Valeurs possibles pour les champs des actualités.
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.
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.
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éthode | Chemin | Description |
|---|---|---|
| GET | /v1/operation | Recherche d'opérations (deals) avec filtres typés |
| GET | /v1/operation/{id} | Détail complet d'une opération |
| GET | /v1/vehicule | Recherche de véhicules d'investissement |
| GET | /v1/vehicule/{id} | Détail d'un véhicule |
| GET | /v1/acteur | Recherche d'acteurs (fonds, conseils financiers et juridiques, prêteurs) |
| GET | /v1/acteur/{id} | Détail d'un acteur |
| GET | /v1/acteurs/fund_list | Liste paginée des fonds d'investissement |
| GET | /v1/societe | Recherche de sociétés |
| GET | /v1/societe/{id} | Détail d'une société |
| GET | /v1/mouvement | Recherche de mouvements (nominations) |
| GET | /v1/mouvement/{id} | Détail d'un mouvement |
| GET | /v1/mouvement/silent-move | Personnalités en transition, rattachées à la fiche placeholder « NON RATTACHE(E) » |
| GET | /v1/people | Recherche de personnalités |
| GET | /v1/people/{id} | Détail d'une personnalité |
| GET | /v1/actif | Recherche d'actifs d'infrastructure |
| GET | /v1/actif/{id} | Détail d'un actif |
| GET | /v1/actualite | Recherche 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éthode | Chemin | Description |
|---|---|---|
| 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éthode | Chemin | Entité concernée |
|---|---|---|
| GET | /v1/operation/field-values | Opérations |
| GET | /v1/acteur/field-values | Acteurs |
| GET | /v1/societe/field-values | Sociétés |
| GET | /v1/vehicule/field-values | Véhicules |
| GET | /v1/people/field-values | Personnalités |
| GET | /v1/mouvement/field-values | Mouvements |
| GET | /v1/actif/field-values | Actifs |
| GET | /v1/actualite/field-values | Actualités |
Compte
| Méthode | Chemin | Description |
|---|---|---|
| GET | /v1/account/quota | État du quota mensuel |
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.
| HTTP | Code applicatif | Signification | Action 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.
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 ?
| Endpoint | Type de fiche | Nb filtres typés | Filtres clés |
|---|---|---|---|
| /v1/operation | Opérations / Deals | 32 | depuis, jusquau, op_type[], op_sstype[], Montantmin … |
| /v1/vehicule | Véhicules d'investissement | 32 | vehicle_nom, vehicle_soc_nom, vehicle_invest, vehicle_advice, vehicle_segment[] … |
| /v1/acteur | Acteurs (fonds, conseils…) | 44 | acteur_nom, uniqut_citation_article, tranche_invest[], aum_min, aum_max … |
| /v1/societe | Sociétés (cibles, portefeuilles…) | 31 | soc_nom, soc_region[], soc_dpt[], soc_zone[], soc_activity[] … |
| /v1/mouvement | Mouvements / Nominations | 18 | mvt_nom, mvt_category, mvt_nationality, mvt_dureemin, mvt_dureemax … |
| /v1/people | Personnalités | 34 | people_nom, people_domaine, people_practice, people_region[], people_dpt[] … |
| /v1/actualite | Articles | ~14 | title, sector[], theme[], keyword[], related-actor[], date_between … |
| /v1/actif | Actifs d'infrastructure | 5 | asset_name, asset_region[], asset_type[], asset_ca_interval[], asset_nationality[] … |
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ètre | Type | Description & valeurs |
|---|---|---|
| depuis | date | Date d'opération - Début · format d/m/Y |
| jusquau | date | Date 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_sstyperequiert op_type |
| Montantmin | number | Montant de l'opération (en M€) - min |
| Montantmax | number | Montant 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_montant | bool | Exclure 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_conseil | string | Conseils, préteur(s) |
| vehicle_used | string | Véhicule utilisé |
| op_nom | string | Actif 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_valorisationmin | number | Valorisation (en M€) - min |
| op_valorisationmax | number | Valorisation (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_fourchette | bool | Inclure les fourchettes correspondantes si la valorisation exacte n'est pas connue · valeur attendue : oui |
| op_invest | string | Acqué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_operator | string | Opé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_isbuyertech | bool | Entreprise de la TECH uniquement (acquéreur) |
| op_buyer_nationality | string | Nationalité de l'acquéreur · Valeurs : FR France · ETRANGER Étranger |
| op_buyer | bool | Restreindre aux acquéreurs / investisseurs · valeur attendue : oui |
| op_solder | bool | Restreindre aux cédants · valeur attendue : oui |
| keyword_operator | string | Opé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ètre | Type | Description & valeurs |
|---|---|---|
| acteur_nom | string | Nom (investisseur ou conseil) |
| uniqut_citation_article | bool | Est 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_min | number | Montant sous gestion / AUM (M€) Min |
| aum_max | number | Montant sous gestion / AUM (M€) Max |
| investment_type | int | Type d'investisseur (fonds uniquement) · 19 valeurs — identifiants : /v1/acteur/field-values?field[]=investment_type |
| asset_type | int | Type(s) d'actif(s) visé(s) · 15 valeurs — identifiants : /v1/acteur/field-values?field[]=asset_type |
| fund_type | bool | Fonds 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_profile | int | Profil 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_date | date | Date 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/Yincompatible avec fund_focus |
| op_date_end_date | date | Date 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/Yincompatible 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 Corporateincompatible 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_sstypeincompatible 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ésincompatible 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_dfincompatible 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_regionincompatible avec fund_focus |
| display_actor_deal_top | bool | Gé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 classementincompatible avec fund_focus |
| uniqut_istech | bool | Fonds TECH · valeur attendue : oui |
| invest_min | number | Montant des investissements (M€) Min |
| invest_max | number | Montant 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_offices | bool | Inclure 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_secteurincompatible avec fund_focus |
| op_desc | string | Descriptif 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_deal | bool | Sans 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_dealincompatible avec fund_focus |
| op_exclude_actor_cible | bool | Exclure 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 : trueincompatible avec fund_focus |
| op_cible_tech | bool | Cible 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 : trueincompatible 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_limit | int | Taille 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_limitrequiert display_actor_deal_topincompatible avec fund_focus |
| fund_focus | bool | Uniquement 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_operator | string | Opé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_year | int | Duré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-min | int | Duré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-max | int | Duré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ètre | Type | Description & valeurs |
|---|---|---|
| soc_nom | string | Nom |
| 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_min | number | Année de création (min) |
| creation_year_max | number | Année de création (max) |
| op_date_start_date | date | Date 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/Yincompatible avec fund_focus |
| op_date_end_date | date | Date 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/Yincompatible avec fund_focus |
| no_deal | bool | Sans 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_dealincompatible avec fund_focus |
| op_cible_tech | bool | Cible 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 : trueincompatible 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é cibleincompatible 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 Corporateincompatible 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_sstypeincompatible 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_secteurincompatible 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_dfincompatible 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_regionincompatible avec fund_focus |
| display_actor_deal_top | bool | Gé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 : trueincompatible avec fund_focus |
| league_table_limit | int | Taille 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_limitrequiert display_actor_deal_topincompatible avec fund_focus |
| fund_focus | bool | Uniquement 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_operator | string | Opé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_year | int | Duré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-min | int | Duré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-max | int | Duré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ètre | Type | Description & valeurs |
|---|---|---|
| vehicle_nom | string | Nom |
| uniqut_citation_article | bool | Cité dans un article CFNEWS INFRA (envoyer oui) |
| vehicle_soc_nom | string | Société de gestion |
| vehicle_invest | string | Investisseur du fonds |
| vehicle_advice | string | Conseil |
| 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 |
| Montantmin | number | Montant levé min |
| Montantmax | number | Montant levé max |
| depuis | date | Date de statut (depuis le) · format d/m/Y |
| jusquau | date | Date de statut (jusqu'au) · format d/m/Y |
| op_date_start_date | date | Date 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/Yincompatible avec fund_focus |
| op_date_end_date | date | Date 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/Yincompatible avec fund_focus |
| no_deal | bool | Sans 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 Corporateincompatible 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_sstypeincompatible 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_dfincompatible 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_regionincompatible avec fund_focus |
| display_actor_deal_top | bool | Gé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 classementincompatible 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_secteurincompatible 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_limit | int | Taille 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_limitrequiert display_actor_deal_topincompatible 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ètre | Type | Description & valeurs |
|---|---|---|
| mvt_nom | string | Personnalité (nom) |
| mvt_category | int | Catégorie · Valeurs : 375347 Conseil financier · 375349 Conseil juridique · 375348 Investisseurs · 375346 Société |
| mvt_nationality | string | Nationalité (de la nouvelle organisation) · 250 valeurs |
| mvt_dureemin | number | Ancienneté (en mois) Min |
| mvt_dureemax | number | Ancienneté (en mois) Max |
| mvt_new_orga | string | Nouvelle organisation |
| mvt_ssdomaine[] | int[] | Domaine d'activité ou expertise · 60 valeurs — identifiants : /v1/mouvement/field-values?field[]=mvt_ssdomaine |
| region | int | Ré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_orga | string | Ancienne organisation |
| depuis | date | Date mouvement - entre le · format d/m/Y |
| jusquau | date | Date mouvement - et le · format d/m/Y |
| depuis_creation | date | Date de création ANALYSTE - début · format d/m/Y |
| jusquau_creation | date | Date de création ANALYSTE - fin · format d/m/Y |
| depuis_maj | date | Date de mise à jour ANALYSTE - début · format d/m/Y |
| jusquau_maj | date | Date de mise à jour ANALYSTE - fin · format d/m/Y |
| silent_move | bool | Personnalités en silent move (non rattachées) · valeur attendue : true |
| silent_move_period | int | Pé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ètre | Type | Description & valeurs |
|---|---|---|
| people_nom | string | Nom (Prénom) |
| people_domaine | int | Domaine · Valeurs : 368371 Avocats · 368535 Banquiers · 368558 Conseils · 368353 Fonds d'investissement · 368594 Sociétés |
| people_practice | int | Practice · 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_societe | string | Organisation |
| 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_li | bool | Uniquement avec un linkedIN renseigné · valeur attendue : oui |
| op_date_start_date | date | Date 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/Yincompatible avec fund_focus |
| op_date_end_date | date | Date 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/Yincompatible 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 Corporateincompatible 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_sstypeincompatible 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 1000incompatible 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 1000incompatible 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_dfincompatible 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_regionincompatible avec fund_focus |
| display_actor_deal_top | bool | Gé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 classementincompatible 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_secteurincompatible avec fund_focus |
| op_desc | string | Descriptif 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_tech | bool | Cible 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 : trueincompatible avec fund_focus |
| minoritaire | bool | Fond 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 |
| majoritaire | bool | Fond 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_limit | int | Taille 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_limitrequiert display_actor_deal_topincompatible avec fund_focus |
| fund_focus | bool | Uniquement 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_year | int | Duré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-min | int | Duré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-max | int | Duré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ètre | Type | Description |
|---|---|---|
| title | string[] | Mots dans le titre (séparés par ;, à encoder %3B dans une URL) |
| intro_full | string[] | 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_end | date | Format Y-m-d (différent du reste : ex. 2025-07-13) |
| date_between | string[] | Plage(s) Y-m-d;Y-m-d (le ; doit être encodé %3B dans une URL) |
| sort / sort_direction | enum | Tri par publication_date ou modification_date · asc/desc |
/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ètre | Type | Description & valeurs |
|---|---|---|
| asset_name | string | Nom 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 :
| Endpoint | Exemple |
|---|---|
| /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
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®ion[]=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§or[]=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§or[]=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)
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.
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.
Console Swagger interactive
Testez tous les endpoints en direct sans écrire une ligne de code, depuis api.cfnewsinfra.net/doc.
Ouvrir la console →Génération de clients
SDK auto-générés en Python, TypeScript, Java, PHP, C#… via openapi-generator. Types stricts garantis.
Documentation embarquée
Rendu visuel via Redoc ou Stoplight pour intégrer la doc dans votre portail interne.
Test & exploration
Import direct dans Postman, Insomnia ou Bruno. Collections prêtes à l'emploi.
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.
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.