LinkedIn Search People
LinkedIn Search People transforme la valeur keywords de chaque URL de recherche de personnes envoyée en requête de fournisseur centrée sur le nom. Les résultats sont des profils publics candidats à vérifier, et non la preuve qu’un profil correspond à la personne recherchée ; l’endpoint ne rejoue pas les filtres d’entreprise, d’école, de lieu, de secteur ou de relation encodés dans l’URL.
Fonctionnalités de la LinkedIn Search People API
- URL de recherche de personnes en entréeEnvoyez une ou plusieurs URL LinkedIn publiques dont le chemin commence par /search/results/people.
- Correspondance explicite des nomsDécode keywords, associe son premier mot (délimité par des espaces) à first_name et réunit les mots restants dans last_name.
- Découverte de profils candidatsObtenez des URL de profils publics et un contexte d’identité qui facilitent un rapprochement manuel ou une collecte ultérieure propre au profil.
- Comptes canoniquesRenvoie des champs stables d’identité, de description, d’image, de site web, d’état du compte, de lieu, d’indicateurs et de collecte.
- Fidélité à la source avec valeurs nullesLes champs indisponibles restent à null : aucune déduction sur des coordonnées privées, un parcours professionnel, une formation, des compétences ni la certitude d’identité.
Paramètres de la LinkedIn Search People API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Liste obligatoire d’URL LinkedIn publiques en http ou https. Chaque hôte doit être linkedin.com ou un sous-domaine de LinkedIn, et chaque chemin doit commencer par /search/results/people. Incluez keywords pour obtenir un comportement fiable axé sur le nom. |
Comment utiliser la LinkedIn Search People API
Préparez des URL de recherche de personnes centrées sur le nom, envoyez la tâche asynchrone, puis examinez chaque candidat renvoyé.
- Créez une URL de recherche de personnes LinkedIn dont la valeur de requête keywords contient le nom de la personne.
- Envoyez urls en POST à /v1/linkedin/search-people et conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à l’obtention d’un statut final.
- Une fois la tâche réussie, traitez data.results.items et suivez next_cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/linkedin/search-people" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.linkedin.com/search/results/people/?keywords=Aakash%20Gupta"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCas d’usage de la LinkedIn Search People API
- Découverte d’URL de profils : Trouvez des URL de profils LinkedIn publics candidats avant d’utiliser un endpoint de collecte propre au profil.
- Résolution manuelle d’identité : Comparez les noms, descriptions, lieux, images et URL des candidats tout en conservant l’incertitude.
- Alimentation d’annuaires publics : Alimentez une file de revue avec des comptes candidats normalisés, sans promesse d’enrichissement de coordonnées ni d’attributs privés.
- Recherche de variantes de nom : Lancez séparément des orthographes de nom soigneusement choisies et comparez les candidats publics obtenus à chaque moment de collecte.
Conseils d’expert pour la LinkedIn Search People API
- Incluez toujours une valeur keywords pertinente : une URL valide qui en est dépourvue crée une ligne de nom vide dont le comportement côté fournisseur n’est pas fiable.
- Rappelez-vous que Mary Jane Smith est associé à first_name Mary et à last_name Jane Smith, et non traité comme une expression de mots-clés générale.
- Ne supposez pas que les filtres de lieu, d’entreprise, d’école, de secteur ou de relation présents dans l’URL sont appliqués ; l’adaptateur actuel les ignore.
- Appuyez-vous sur l’URL du profil public et sur plusieurs attributs concordants avant d’identifier une personne.
- Dédoublonnez les candidats répétés par URL de profil stable lorsque plusieurs recherches envoyées se recoupent.
- Aucune limite de résultats n’est contrôlée par l’appelant : concevez vos workflows de facturation et de revue autour des résultats réellement stockés.
API associées
En complément de la LinkedIn Search People API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques LinkedIn.
- LinkedIn Profiles API — Normalisez l’identité publique d’un profil, ses postes, localisation, nombres d’audience visibles, expérience, formation et compétences à partir d’URL de profils.
- LinkedIn Companies API — Normalisez les descriptions publiques d’entreprises, sites web, logos, nombres visibles d’abonnés et d’employés, secteurs, localisations et spécialités.
- LinkedIn Posts API — Collectez le texte des publications publiques, auteurs, l’engagement visible, médias, date de publication, type et hashtags à partir d’URL prises en charge.
- LinkedIn Jobs API — Normalisez les intitulés de postes publics, entreprises, descriptions, lieux, qualifications, informations sur le contrat, liens de candidature et champs de salaire disponibles.
- LinkedIn Profile Posts API — Repérez les publications publiques associées à des URL de profils LinkedIn, avec contexte de l’auteur, médias, hashtags, horodatages et engagement visible.
- LinkedIn Search Posts API — Repérez les publications LinkedIn publiques indexées par Google à partir d’un mot-clé et d’une date facultative, avec contenu, auteurs, médias, tags, horodatages et engagement visible normalisés.