linkedin/
search-jobs

Recherchez des offres d’emploi LinkedIn publiques par lieu et filtres facultatifs du fournisseur, avec des champs normalisés : poste, entreprise, lieu, contrat, expérience, télétravail, salaire et dates.

LinkedIn Search Jobs API

Lieu obligatoire
Découverte structurée
Offres canoniques
0,5 crédit par résultat
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

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ètresObligatoireDescription
locationObligatoireChaîne de lieu obligatoire et non vide, utilisée pour construire la requête de découverte du fournisseur.
keywordFacultatifChaîne facultative et non vide (poste, compétence ou sujet) transmise au fournisseur.
countryFacultatifChaîne facultative et non vide de filtre par pays, transmise sans traduction côté SocQ.
time_rangeFacultatifChaîne facultative et non vide d’ancienneté ou de période, propre au fournisseur.
job_typeFacultatifChaîne facultative et non vide de filtre par type d’emploi ou de contrat, propre au fournisseur.
experience_levelFacultatifChaîne facultative et non vide de filtre par expérience ou séniorité, propre au fournisseur.
remoteFacultatifChaîne facultative et non vide de filtre par mode de travail ou télétravail, propre au fournisseur.
companyFacultatifChaîne facultative et non vide de filtre par entreprise, transmise au fournisseur.
selective_searchFacultatifBooléen facultatif transmis au fournisseur pour contrôler son comportement de recherche sélective.
jobs_to_not_includeFacultatifListe facultative de chaînes d’exclusion non vides, transmises au fournisseur.
location_radiusFacultatifChaîne facultative et non vide de rayon, propre au fournisseur, associée à la requête de lieu.
results_limitFacultatifPlafond 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.

  1. Choisissez un lieu (obligatoire) et n’ajoutez que des valeurs de filtre dont vous avez testé l’interprétation.
  2. Envoyez la requête en POST à /v1/linkedin/search-jobs et conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche atteigne un statut final.
  4. 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 true

Cas 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.

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.

Explorer d’autres plateformes

Combinez les données LinkedIn avec les données publiques d’autres plateformes sociales prises en charge.

LinkedIn Search Jobs API — FAQ

LinkedIn Search Jobs API est une interface qui permet de découvrir les offres d’emploi LinkedIn publiques à partir d’un lieu obligatoire et de filtres facultatifs du fournisseur. Elle renvoie des champs normalisés de poste, d’entreprise, de lieu, de contrat, d’expérience, de télétravail, de salaire et de dates pour les offres disponibles au moment de la collecte.

location est obligatoire et doit contenir une chaîne non vide. Fournir uniquement un mot-clé, une entreprise ou un autre filtre facultatif ne satisfait pas le validateur actuel.

Non. SocQ transmet les chaînes de filtre non vides au fournisseur de découverte, sans définir ni traduire les orthographes et combinaisons acceptées.

Non. C’est un plafond entier de 1 à 2 000, avec 100 par défaut. La disponibilité publique, les combinaisons de filtres, la pagination, les doublons et le comportement du fournisseur peuvent produire moins d’enregistrements.

Non. Chaque résultat est un enregistrement public pris au moment de la collecte. Vérifiez l’état des candidatures, les missions, les contraintes de lieu et la rémunération sur l’offre avant d’agir.

Non. L’endpoint ne postule pas, n’enregistre pas d’offres, ne crée pas d’alertes, ne récupère pas de candidats, n’accède pas à Recruiter et ne fournit pas de scores de correspondance personnalisés.

Chaque offre renvoyée coûte 0,5 crédit SocQ, sans frais de base. L’estimation par défaut est de 100 résultats, un jeu de résultats vide n’entraîne aucune facturation de résultat, et l’utilisation réelle peut dépasser l’estimation lorsque cela est autorisé.