LinkedIn Jobs
Une offre d’emploi LinkedIn publique décrit un poste précis par son intitulé, son employeur, sa description, son lieu, son niveau de séniorité, son type de contrat, son secteur, son circuit de candidature et son éventuelle rémunération publiée. Ces informations servent au suivi des postes vacants, à la comparaison de rôles, à l’étude du recrutement et à la constitution de catalogues d’offres structurés.
Fonctionnalités de la LinkedIn Jobs API
- Entrée : URL de détail d’une offreTraitez une ou plusieurs pages publiques LinkedIn /jobs/view/{slug}, tout en rejetant les résultats de recherche et les URL de collections d’offres.
- Poste et employeur dans un seul enregistrementRenvoie ensemble l’intitulé du poste, la description complète, l’URL de l’offre et l’identité publique normalisée de l’entreprise qui recrute.
- Attributs d’emploi structurésExpose le lieu, le niveau de séniorité, le type de contrat et les secteurs comme des champs distincts, au lieu de les laisser dans la description.
- Champs de candidature et de rémunérationRenvoie apply_link, le signal Easy Apply, le salaire, la date de publication et la date de collecte comme champs d’offre séparés.
Paramètres de la LinkedIn Jobs API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Liste obligatoire d’URL de détail d’offres LinkedIn publiques. Chaque URL doit utiliser le chemin /jobs/view/{slug} sur linkedin.com ou un sous-domaine de LinkedIn. |
Comment utiliser la LinkedIn Jobs API
Envoyez des liens de détail d’offres connus, attendez la préparation des enregistrements d’embauche et récupérez chaque page de résultats disponible.
- Filtrez la liste d’entrée pour ne garder que les liens de détail publics /jobs/view/{slug}.
- Envoyez ces liens dans urls en POST à /v1/linkedin/jobs et conservez task_id.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche d’offres atteigne un statut final.
- En cas de succès, traitez data.results.items et utilisez next_cursor pour toute page signalée par has_more.
curl -X POST "https://api.socq.ai/v1/linkedin/jobs" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.linkedin.com/jobs/view/software-engineer-at-microsoft-4429527118"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCas d’usage de la LinkedIn Jobs API
- Suivi des postes vacants : Servez-vous du poste, de l’employeur, du lieu, de la date de publication et de l’URL source pour tenir une liste structurée des ouvertures connues.
- Comparaison de postes et de prérequis : Comparez descriptions, séniorité, type de contrat, secteur, lieu et salaire éventuel entre des offres choisies.
- Étude du marché du recrutement : Regroupez des offres choisies par employeur, lieu, secteur ou type de contrat pour étudier les tendances d’embauche visibles.
- Gestion des circuits de candidature : Utilisez apply_link et le signal Easy Apply pour orienter chaque offre enregistrée vers son parcours de candidature disponible.
Conseils d’expert pour la LinkedIn Jobs API
- Extrayez et dédoublonnez l’identifiant d’offre dans les liens /jobs/view/, afin que des formes d’URL alternatives ne créent pas d’offres en double.
- Traitez salary comme une donnée source facultative, car de nombreuses offres l’omettent et les valeurs exposées n’ont pas forcément un format commun.
- Validez apply_link avant de le présenter comme une action sortante dans une interface en aval.
- Séparez created_at et collected_at pour ne pas confondre la date de publication avec le moment où l’offre a été récupérée.
API associées
En complément de la LinkedIn Jobs 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 Company Jobs API — Repérez des offres d’emploi publiques à partir d’URL LinkedIn /jobs/ préparées, avec poste, entreprise, lieu, contrat, expérience, télétravail, salaire et calendrier normalisés.
- LinkedIn Company Posts API — Repérez les publications publiques à partir d’URL de pages d’entreprises LinkedIn, avec texte, contexte de l’auteur, médias, hashtags, horodatages et engagement visible.
- LinkedIn Search Jobs API — Recherchez des offres d’emploi LinkedIn publiques à partir d’un lieu obligatoire et de filtres facultatifs, avec poste, entreprise, lieu, contrat, expérience, télétravail, salaire et calendrier normalisés.