LinkedIn Search Jobs
LinkedIn Search Jobs construit une requête de découverte publique à partir d’un lieu obligatoire et de filtres facultatifs. Il renvoie des offres telles qu’elles existaient au moment de la collecte, pour la recherche et l’alimentation de workflows ; une offre renvoyée ne prouve pas que les candidatures restent ouvertes, et un nombre de résultats ne mesure pas directement les recrutements ni les effectifs.
Fonctionnalités de la LinkedIn Search Jobs API
- Découverte par lieuChaque requête commence par un lieu non vide ; vous pouvez ensuite restreindre l’échantillon d’offres publiques avec un mot-clé, un pays, une entreprise ou un autre filtre du fournisseur.
- Filtres sources flexiblesTransmet les valeurs de time_range, job_type, experience_level, remote, company, location_radius, selective_search et d’exclusion sans inventer d’énumérations SocQ.
- Plafond de résultats configurableDéfinissez results_limit de 1 à 2 000 pour la requête de découverte unique ; la valeur par défaut est 100 et le fournisseur peut renvoyer moins d’enregistrements.
- Offres canoniquesObtenez des champs stables pour l’offre, l’entreprise, le lieu, le salaire, la publication, l’expiration et la collecte, au lieu d’une structure propre à chaque fournisseur.
- Fidélité à la source avec valeurs nullesLes valeurs indisponibles de salaire, de télétravail, d’entreprise, d’expérience, de lieu, de publication et d’expiration restent à null au lieu d’être déduites.
Paramètres de la LinkedIn Search Jobs API
| Paramètres | Obligatoire | Description |
|---|---|---|
location | Obligatoire | Chaîne de lieu obligatoire et non vide, utilisée pour construire la requête de découverte du fournisseur. |
keyword | Facultatif | Chaîne facultative et non vide (poste, compétence ou sujet) transmise au fournisseur. |
country | Facultatif | Chaîne facultative et non vide de filtre par pays, transmise sans traduction côté SocQ. |
time_range | Facultatif | Chaîne facultative et non vide d’ancienneté ou de période, propre au fournisseur. |
job_type | Facultatif | Chaîne facultative et non vide de filtre par type d’emploi ou de contrat, propre au fournisseur. |
experience_level | Facultatif | Chaîne facultative et non vide de filtre par expérience ou séniorité, propre au fournisseur. |
remote | Facultatif | Chaîne facultative et non vide de filtre par mode de travail ou télétravail, propre au fournisseur. |
company | Facultatif | Chaîne facultative et non vide de filtre par entreprise, transmise au fournisseur. |
selective_search | Facultatif | Booléen facultatif transmis au fournisseur pour contrôler son comportement de recherche sélective. |
jobs_to_not_include | Facultatif | Liste facultative de chaînes d’exclusion non vides, transmises au fournisseur. |
location_radius | Facultatif | Chaîne facultative et non vide de rayon, propre au fournisseur, associée à la requête de lieu. |
results_limit | Facultatif | Plafond entier facultatif pour cette requête. La valeur par défaut est 100, le minimum 1 et le maximum 2 000. |
Comment utiliser la LinkedIn Search Jobs API
Envoyez une requête fondée sur un lieu, interrogez la tâche asynchrone, puis traitez chaque page de résultats renvoyée.
- Choisissez un lieu (obligatoire) et n’ajoutez que des valeurs de filtre dont vous avez testé l’interprétation.
- Envoyez la requête en POST à /v1/linkedin/search-jobs et conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche atteigne un statut final.
- En cas de succès, traitez data.results.items et suivez next_cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/linkedin/search-jobs" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"location":"Seattle","keyword":"Python","country":"US","results_limit":20}'
# 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 Jobs API
- Découverte de postes par région : Collectez les offres publiques d’une requête poste-et-lieu constante et conservez l’heure de collecte pour des comparaisons ultérieures.
- Revue des employeurs et des postes : Examinez quels employeurs, intitulés, lieux, modes de travail, niveaux d’expérience et types de contrat apparaissent dans l’échantillon renvoyé.
- Disponibilité des rémunérations : Repérez les offres qui affichent un salaire, tout en conservant l’absence de rémunération sous la forme d’un null explicite.
- Alimentation de workflows d’emploi : Injectez les URL et champs normalisés d’offres publiques dans des workflows de revue, de déduplication, d’alerte ou d’analyse en aval.
Conseils d’expert pour la LinkedIn Search Jobs API
- Testez l’orthographe des filtres propres au fournisseur sur une petite requête avant de les utiliser dans un workflow récurrent.
- Utilisez les mêmes filtres et le même calendrier de collecte pour comparer des lieux ou des dates.
- Dédoublonnez par ID d’offre stable ou par URL de l’offre, car des recherches renouvelées ou qui se chevauchent peuvent faire remonter le même poste.
- Considérez les libellés de télétravail comme des signaux de la source et lisez la description pour repérer les contraintes géographiques, de résidence ou de fuseau horaire.
- Gardez published_at, expires_at et collected_at distincts, afin de ne pas confondre la date de l’offre et celle de la récupération.
- Considérez un résultat vide comme une issue de collecte parmi d’autres, et non comme la preuve qu’il n’existe aucune offre publique correspondante.
API associées
En complément de la LinkedIn Search 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 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 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.