Personnes

Rechercher des personnes

Recherche de contacts (dirigeants légaux et/ou profils LinkedIn). Renvoie un total et une page de résultats. Pour compter sans extraire ni être facturé, envoyer countOnly: true (ou limit: 0) : la réponse contient total et un leads vide. Sinon, chaque enregistrement renvoyé coûte 1 crédit. La page 1 est accessible sans abonnement ; la pagination (page > 1) requiert un abonnement actif.

post/people/find

Request

Base URL: https://api.basile.cc
URL: https://api.basile.cc/people/find
Auth: API key in header Authorization

Request body

limitinteger

Taille de page (défaut 100). Cap = 1000 en mode normal ; 5000 en mode idsOnly côté /people/find (companies reste à 1000). 0 = compter seulement (équivalent à countOnly: true, gratuit). ⚠️ 1 n'est PAS un mode de comptage : cela renvoie 1 enregistrement, donc 1 crédit — utiliser countOnly.

countOnlyboolean

Si true, /find ne renvoie que le total avec un tableau leads vide : c'est le mode de comptage gratuit (aucun enregistrement renvoyé, donc aucun crédit débité), quel que soit le nombre de résultats. Équivalent à limit: 0. À utiliser systématiquement pour cadrer un volume avant d'extraire.

paginationTokenstring

Curseur opaque renvoyé dans pagination.nextToken pour la page suivante.

idsOnlyboolean

Si true, /find ne renvoie que { _id, source } (champ data vide), sans enrichissement par ligne — beaucoup plus léger et rapide pour collecter les IDs d'un grand résultat. Permet limit jusqu'à 5000 côté /people/find. À utiliser quand on a besoin de la liste d'IDs avant un export par { ids } ou un ré-enrichissement par lots. Pour un simple CSV, préférer /export par filters (export streamé, jusqu'à la limite par export du plan).

employerFallbackboolean

Recherche de personnes dans une société (employer ou siren) par clé d'API : false garde le comportement strict quand la recherche telle quelle rend zéro (aucune récupération : nom nettoyé, SIREN du registre, page au nom de la société, holding, intitulés de dirigeant). Les avertissements de meta.warnings restent.

registryMandatesboolean

Dirigeants d'un SIREN par clé d'API (siren + mandate_role) : false garde le comportement d'avant, seules les fiches RATTACHÉES au SIREN (ni mandats lus au registre, ni holdings, ni repli LinkedIn).

Example request

{
  "filters": {
    "result_full_name": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    },
    "result_first_name": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    },
    "result_last_name": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    },
    "result_role": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    },
    "activity": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    },
    "company_headcount": {
      ">=": 40,
      "<=": 55
    },
    "employer": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    },
    "result_city": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    },
    "result_country_code": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    },
    "mandate_role": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    },
    "siren": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    },
    "legal_name": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    },
    "nationality": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    },
    "nationality_code": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    },
    "result_postal_code": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    },
    "result_age": {
      ">=": 40,
      "<=": 55
    },
    "result_total_companies_count": {
      ">=": 40,
      "<=": 55
    },
    "current_seniority": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    },
    "current_job_functions": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    },
    "skills": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    },
    "languages": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    },
    "education": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    },
    "past_title": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    },
    "past_employer": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    },
    "connection_count": {
      ">=": 40,
      "<=": 55
    },
    "current_tenure_years": {
      ">=": 40,
      "<=": 55
    },
    "linkedin_url": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    }
  }
}

Response

Résultats paginés.

successboolean

totalinteger

Total de résultats (somme des sources, sans dédup cross-source).

Example response

{
  "leads": [
    {
      "mandate": {
        "label": "Président de X via HOLDING Y"
      }
    }
  ],
  "meta": {
    "warnings": [
      {
        "code": "company_role_absent",
        "message": "ALTRAD ARNHOLDT (SIREN 400035903): 59 employees known on LinkedIn, none holds this role (Achat, Acheteur, Acheteuse…).",
        "messageFr": "ALTRAD ARNHOLDT (SIREN 400035903) : 59 salariés connus sur LinkedIn, aucun n'a ce rôle (Achat, Acheteur, Acheteuse…)."
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.