create_saved_search
Declared idempotentShow server-provided details
Server description (copied; language not verified)
Creation d'une recherche sauvegardee pour l'utilisateur, visible dans l'app Insourcia (page /news - Veille).
Utiliser cet outil quand l'utilisateur veut SAUVEGARDER une recherche pour la suivre dans le temps (veille marche, suivi d'un secteur, pipeline de cibles) - pas pour une recherche ponctuelle (utiliser search_companies).
Fonctionnement :
- Les filtres acceptes sont les MEMES que search_companies (query texte libre + filtres geographie/secteur/financier/dirigeants/groupe + advanced_filters JSON). Au moins un critere est requis.
- Idempotent : si une recherche sauvegardee ACTIVE du meme nom existe deja pour l'utilisateur, elle est renvoyee telle quelle (already_exists=true), sans doublon et sans modifier son alerte.
- Alerte quotidienne ACTIVE PAR DEFAUT (enable_alert=false pour s'en passer) : elle notifie l'utilisateur (page /news + email) quand de NOUVELLES societes entrent dans les criteres de la recherche. A la creation, une notification initiale recapitule les 90 derniers jours ; ensuite seules les entrees futures declenchent.
Reponse : { id, name, url (page /news), result_count (nombre de societes matchant actuellement, null si indisponible), filters (filtres normalises stockes, absent sur le hit idempotent), already_exists, alert_enabled }.
Input schema (truncated preview — do not copy)
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "Nom de la recherche sauvegardee, court et parlant. Ex: \"SaaS Bretagne CA > 5M\". 1-255 caracteres."
},
"query": {
"type": "string",
"description": "Nom, SIREN, mot-cle activite, ou \"*\" pour rechercher uniquement par filtres"
},
"ville": {
"type": "string"
},
"ca_max": {
"type": "number"
},
"ca_min": {
"type": "number"
},
"radius": {
"type": "integer",
"maximum": 200,
"minimum": 1
},
"region": {
"type": "string"
},
"statut": {
"enum": [
"ACTIVE",
"DISSOLVED"
],
"type": "string"
},
"code_naf": {
"type": "string"
},
"is_cotee": {
"type": "boolean"
},
"latitude": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"longitude": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"cagr_ca_max": {
"type": "number"
},
"cagr_ca_min": {
"type": "number"
},
"code_postal": {
"type": "string"
},
"departement": {
"type": "string"
},
"est_filiale": {
"type": "boolean"
},
"has_website": {
"type": "boolean"
},
"credit_grade": {
"type": "array",
"items": {
"enum": [
"AAA",
"AA",
"A",
"BBB",
"BB",
"B",
"CCC",
"D"
],
"type": "string"
}
},
"effectif_max": {
"type": "number"
},
"effectif_min": {
"type": "number"
},
"enable_alert": {
"type": "boolean",
"description": "Notification quotidienne des nouvelles societes qui matchent. Defaut: true ici, false via l'API REST."
},
"filter_annee": {
"type": "number"
},
"siren_groupe": {
"type": "string"
},
"credit_scored": {
"type": "boolean"
},
"dirigeant_nom": {
"type": "string"
},
"groupe_parent": {
"type": "string"
},
"plan_en_cours": {
"type": "boolean"
},
"tresorerie_max": {
"type": "number"
},
"tresorerie_min": {
"type": "number"
},
"advanced_filters": {
"anyOf": [
{
"type": "object",
"properties": {
"ca_max": {
"type": "number",
"description": "CA maximum (euros)"
},
"a_fonds": {
"type": "boolean",
"description": "true = detenue par un fonds d'investissement PE/VC"
},
"bfr_max": {
"type": "number"
},
"bfr_min": {
"type": "number"
},
"est_ess": {
"type": "boolean",
"description": "true = economie sociale et solidaire"
},
"a_fusionne": {
"type": "boolean",
"description": "true = a participe a une fusion"
},
"ebitda_max": {
"type": "number",
"description": "EBITDA maximum"
},
"ebitda_min": {
"type": "number",
"description": "EBITDA minimum"
},
"cagr_ca_max": {
"type": "number"
},
"capital_max": {
"type": "number",
"description": "Capital social maximum"
},
"capital_min": {
"type": "number",
"description": "Capital social minimum"
},
"effectif_max": {
"type": "number",
"description": "Tranche INSEE maximum"
},
"data_freshness": {
"type": "number",
"description": "Fraicheur des bilans en annees. Ex: 2 pour bilans < 2 ans"
},
"dividendes_max": {
"type": "number"
},
"dividendes_min": {
"type": "number"
},
"nb_brevets_min": {
"type": "number",
"description": "\"entreprises avec brevets\" -> 1"
},
"nb_marches_max": {
"type": "number"
},
"nb_marches_min": {
"type": "number",
"description": "\"entreprises avec marches publics\" -> 1"
},
"tresorerie_max": {
"type": "number"
},
"cagr_rn_1an_max": {
"type": "number"
},
"cagr_rn_1an_min": {
"type": "number"
},
"dette_nette_max": {
"type": "number"
},
"dette_nette_min": {
"type": "number"
},
"marge_brute_max": {
"type": "number"
},
"marge_brute_min": {
"type": "number"
},
"marge_nette_max": {
"type": "number"
},
"marge_nette_min": {
"type": "number"
},
"nb_cessions_max": {
"type": "number"
},
"nb_cessions_min": {
"type": "number"
},
"total_actif_max": {
"type": "number"
},
"total_actif_min": {
"type": "number"
},
"cagr_ca_2ans_max": {
"type": "number"
},
"cagr_ca_2ans_min": {
"type": "number"
},
"cagr_ca_3ans_max": {
"type": "number"
},
"cagr_ca_3ans_min": {
"type": "number"
},
"cagr_ca_5ans_max": {
"type": "number"
},
"cagr_ca_5ans_min": {
"type": "number"
},
"cagr_rn_2ans_max": {
"type": "number"
},
"cagr_rn_2ans_min": {
"type": "number"
},
"cagr_rn_3ans_max": {
"type": "number"
},
"cagr_rn_3ans_min": {
"type": "number"
},
"cagr_rn_5ans_max": {
"type": "number"
},
"cagr_rn_5ans_min": {
"type": "number"
},
"marge_ebitda_max": {
"type": "number"
},
"marge_ebitda_min": {
"type": "number"
},
"resultat_net_max": {
"type": "number",
"description": "Resultat net maximum"
},
"age_dirigeant_min": {
"type": "number",
"description": "Age minimum (annees)"
},
"date_creation_max": {
"type": "string"
},
"civilite_dirigeant": {
"enum": [
"homme",
"femme",
"M",
"Mme",
"H",
"F"
],
"type": "string",
"description": "Genre du dirigeant. Au moins un dirigeant doit correspondre."
},
"comptes_consolides": {
"type": "boolean",
"description": "true = consolides, false = sociaux uniquement"
},
"date_radiation_max": {
"type": "string"
},
"date_radiation_min": {
"type": "string"
},
"effectif_moyen_max": {
"type": "number"
},
"effectif_moyen_min": {
"type": "number",
"description": "Effectif exact des bilans, minimum"
},
"nb_subventions_min": {
"type": "number",
"description": "\"entreprises subventionnees\" -> 1"
},
"valeur_ajoutee_max": {
"type": "number"
},
"valeur_ajoutee_min": {
"type": "number"
},
"cagr_ebitda_1an_max": {
"type": "number"
},
"cagr_ebitda_1an_min": {
"type": "number"
},
"categorie_juridique": {
"type": "string",
"description": "Code INSEE de categorie juridique, plusieurs separes par virgule. Ex: \"5710\" SAS, \"5720\" SASU, \"5599\" SA, \"5499\" SARL"
},
"est_societe_mission": {
"type": "boolean"
},
"cagr_ebitda_2ans_max": {
"type": "number"
},
"cagr_ebitda_2ans_min": {
"type": "number"
},
"cagr_ebitda_3ans_max": {
"type": "number"
},
"cagr_ebitda_3ans_min": {
"type": "number"
},
"cagr_ebitda_5ans_max": {
"type": "number"
},
"cagr_ebitda_5ans_min": {
"type": "number"
},
"capitaux_propres_max": {
"type": "number"
},
"capitaux_propres_min": {
"type": "number"
},
"comptes_confidentiels": {
"type": "boolean",
"description": "true = comptes confidentiels, false = comptes publies"
},
"ratio_endettement_max": {
"type": "number"
},
"ratio_endettement_min": {
"type": "number"
},
"dettes_financieres_max": {
"type": "number"
},
"dettes_financieres_min": {
"type": "number"
},
"dettes_fournisseurs_max": {
"type": "number"
},
"dettes_fournisseurs_min": {
"type": "number"
},
"nb_filiales_directes_max": {
"type": "number"
},
"nb_filiales_directes_min": {
"type": "number"
},
"cac_date_debut_mandat_max": {
"type": "string"
},
"cac_date_debut_mandat_min": {
"type": "string",
"description": "Date de debut de mandat du commissaire aux comptes (titulaire ou suppleant), minimum"
},
"derniere_cession_date_max": {
"type": "string"
},
"derniere_cession_date_min": {
"type": "string"
},
"resultat_exploitation_max": {
"type": "number"
},
"resultat_exploitation_min": {
"type": "number"
},
"capacite_autofinancement_max": {
"type": "number"
},
"capacite_autofinancement_min": {
"type": "number"
},
"delai_paiement_clients_jours_max": {
"type": "number"
},
"delai_paiement_clients_jours_min": {
"type": "number"
},
"delai_paiement_fournisseurs_jours_max": {
"type": "number"
},
"delai_paiement_fournisseurs_jours_min": {
"type": "number"
}
},
"description": "Filtres avances. Rappel include_fields : nb_marches_min -> nb_marches_titulaire,montant_marches_titulaire ; nb_subventions_min -> nb_subventions,montant_subventions_total ; nb_brevets_min -> nb_brevets,nb_brevets_actifs ; dividendes_min -> dividendes_verses.",
"additionalProperties": false
},
{
"type": "string",
… [server-provided details truncated]