Documentation API Hop
Référence des endpoints LinkedIn
13 endpoints LinkedIn Web V2 authentifiés donnent accès aux profils de membres et d’entreprises, publications, offres d’emploi, recherches et commentaires.
13 endpoints LinkedIn Web V2 authentifiés donnent accès aux profils de membres et d’entreprises, publications, offres d’emploi, recherches et commentaires.
Authentification
Envoyez votre clé API API Hop dans l’en-tête Authorization. L’accès dépend des passerelles activées et des permissions de la clé ; la documentation ne confirme pas une mise en production.
Requêtes
Les opérations synchrones utilisent GET avec des paramètres de requête, sans corps. Les champs inconnus et les champs scalaires répétés sont refusés. Seuls les champs de type tableau acceptent les clés répétées, par exemple company_ids=1035&company_ids=1441. Conservez les identifiants et curseurs sous forme de chaînes ; ne convertissez pas les grands identifiants en nombres JavaScript. Les valeurs facultatives vides sont omises.
Facturation
Pour les opérations synchrones : Les profils de membres, profils d’entreprises et détails de publications coûtent $0.008 (8000 credits) par requête réussie. Les cinq autres opérations coûtent $0.05 (50000 credits). Il s’agit des tarifs clients par défaut ; les tarifs propres au compte prévalent. Chaque page demandée est facturée séparément, pas chaque élément. Un échec fournisseur libère la réservation ; une erreur de règlement ne déclenche pas un nouvel appel.
Pagination et limites
Pour les opérations synchrones : Les publications d’un membre sont limitées aux 50 plus récentes : start et pagination_token sont sans effet, même si la réponse contient un jeton. Les publications d’entreprise utilisent start=0, 50, 100, ... ; pagination_token est sans effet. La recherche d’emploi utilise start=0, 25, 50, .... Les commentaires acceptent page à partir de 1 et pagination_token. Aucun parcours automatique des pages ni nouvelle tentative automatique ; délai maximal de 60 secondes. Des ressources limitées chez le fournisseur peuvent provoquer des échecs intermittents.
Périmètre
Huit opérations synchrones Web V2 et cinq opérations de tâches asynchrones sont disponibles. Créez une tâche de profil, d’entreprise ou de publication avec POST et un champ JSON url. HTTP 202 renvoie un identifiant décimal de tâche de la plateforme sous forme de chaîne. Les lectures GET du statut et du résultat sont gratuites et réservées au même locataire ; une tâche inconnue, d’un autre locataire ou d’un autre produit renvoie 404. Le statut omet result ; le résultat reste null avant COMPLETED. Le prix est réservé à la création et facturé une seule fois en cas de succès ($0.008 / 8000 credits par défaut). Un échec ou un délai de 30 minutes libère la réservation. Le suivi en arrière-plan a lieu toutes les 5 secondes ; les réponses en cours incluent Retry-After: 5. Les résultats sont stockés dans la tâche de la plateforme. N’utilisez pas l’identifiant du fournisseur. Une soumission incertaine n’est pas répétée automatiquement. Une tâche terminée renvoie result.records. Les entiers hors de la plage sûre de JavaScript sont stockés et renvoyés comme chaînes décimales. Les exemples sont illustratifs, pas des résultats de validation réelle.
Profil de membre
web_v2-get_user_profile
GET https://api.apihop.ai/v1/linkedin/web-v2/users/profile
Prix par requête réussie: $0.008 (8000 credits).
| Champ | Obligatoire | Contrat |
|---|---|---|
url | Oui | URL LinkedIn complète; string |
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/users/profile" \
-H "Authorization: Bearer YOUR_API_KEY" \
--data-urlencode "url=https://www.linkedin.com/in/williamhgates/"Publications de membre
web_v2-get_user_posts
GET https://api.apihop.ai/v1/linkedin/web-v2/users/posts
Prix par requête réussie: $0.05 (50000 credits).
| Champ | Obligatoire | Contrat |
|---|---|---|
url | Oui | URL LinkedIn complète; string |
type | Non | Publications, publications commentées ou ayant reçu une réaction; string; posts, comments, reactions; Valeur par défaut: posts |
start | Non | Décalage ; respecter les limites de l’endpoint; integer; >= 0 |
pagination_token | Non | Jeton de pagination ; respecter les limites de l’endpoint; string |
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/users/posts" \
-H "Authorization: Bearer YOUR_API_KEY" \
--data-urlencode "url=https://www.linkedin.com/in/williamhgates/"Profil d’entreprise
web_v2-get_company_profile
GET https://api.apihop.ai/v1/linkedin/web-v2/companies/profile
Prix par requête réussie: $0.008 (8000 credits).
| Champ | Obligatoire | Contrat |
|---|---|---|
url | Oui | URL LinkedIn complète; string |
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/companies/profile" \
-H "Authorization: Bearer YOUR_API_KEY" \
--data-urlencode "url=https://www.linkedin.com/company/microsoft/"Publications d’entreprise
web_v2-get_company_posts
GET https://api.apihop.ai/v1/linkedin/web-v2/companies/posts
Prix par requête réussie: $0.05 (50000 credits).
| Champ | Obligatoire | Contrat |
|---|---|---|
url | Oui | URL LinkedIn complète; string |
start | Non | Décalage ; respecter les limites de l’endpoint; integer; >= 0 |
pagination_token | Non | Jeton de pagination ; respecter les limites de l’endpoint; string |
sort_by | Non | Ordre de tri; string; top, recent |
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/companies/posts" \
-H "Authorization: Bearer YOUR_API_KEY" \
--data-urlencode "url=https://www.linkedin.com/company/microsoft/"Détails d’une offre
web_v2-get_job_detail
GET https://api.apihop.ai/v1/linkedin/web-v2/jobs/detail
Prix par requête réussie: $0.05 (50000 credits).
| Champ | Obligatoire | Contrat |
|---|---|---|
url | Oui | URL LinkedIn complète; string |
include_skills | Non | Inclure les compétences requises; boolean; Valeur par défaut: false |
include_hiring_team | Non | Inclure l’équipe de recrutement; boolean; Valeur par défaut: false |
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/jobs/detail" \
-H "Authorization: Bearer YOUR_API_KEY" \
--data-urlencode "url=https://www.linkedin.com/jobs/view/software-engineer-at-pave-4310512612/"Recherche d’emploi
web_v2-search_jobs
GET https://api.apihop.ai/v1/linkedin/web-v2/jobs/search
Prix par requête réussie: $0.05 (50000 credits).
| Champ | Obligatoire | Contrat |
|---|---|---|
keywords | Non | Mots-clés de recherche; string |
geo_code | Non | Identifiant géographique ; 92000000 signifie le monde entier; integer; Identifiant entier exact |
date_posted | Non | Filtre de date de publication; string; Any time, Past month, Past week, Past 24 hours |
experience_levels | Non | Niveaux d’expérience; string[]; Clé de requête répétée; Internship, Entry level, Associate, Mid-Senior level, Director, Executive |
company_ids | Non | Identifiants d’entreprises; integer[]; Clé de requête répétée; Identifiant entier exact |
title_ids | Non | Identifiants d’intitulés de poste; integer[]; Clé de requête répétée; Identifiant entier exact |
onsite_remotes | Non | Types de lieu de travail; string[]; Clé de requête répétée; On-site, Remote, Hybrid |
functions | Non | Fonctions; string[]; Clé de requête répétée |
industries | Non | Secteurs; string[]; Clé de requête répétée |
job_types | Non | Types de contrat; string[]; Clé de requête répétée; Full-time, Part-time, Contract, Temporary, Internship, Volunteer |
sort_by | Non | Ordre de tri; string; Most relevant, Most recent |
easy_apply | Non | Candidature simplifiée uniquement; boolean; Valeur par défaut: false |
under_10_applicants | Non | Moins de 10 candidats uniquement; boolean; Valeur par défaut: false |
start | Non | Décalage ; respecter les limites de l’endpoint; integer; >= 0 |
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/jobs/search" \
-H "Authorization: Bearer YOUR_API_KEY" \
--data-urlencode "keywords=data analyst" \
--data-urlencode "company_ids=1035" \
--data-urlencode "company_ids=1441"Détails d’une publication
web_v2-get_post_detail
GET https://api.apihop.ai/v1/linkedin/web-v2/posts/detail
Prix par requête réussie: $0.008 (8000 credits).
| Champ | Obligatoire | Contrat |
|---|---|---|
url | Oui | URL LinkedIn complète; string |
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/posts/detail" \
-H "Authorization: Bearer YOUR_API_KEY" \
--data-urlencode "url=https://www.linkedin.com/posts/orlenchner_scrapecon-activity-7180537307521769472-oSYN"Commentaires d’une publication
web_v2-get_post_comments
GET https://api.apihop.ai/v1/linkedin/web-v2/posts/comments
Prix par requête réussie: $0.05 (50000 credits).
| Champ | Obligatoire | Contrat |
|---|---|---|
urn | Oui | URN d’activité de la publication; string |
sort_by | Non | Ordre de tri; string; Most relevant, Most recent |
page | Non | Numéro de page à partir de 1; integer; >= 1 |
pagination_token | Non | Jeton de pagination ; respecter les limites de l’endpoint; string |
share_urn | Non | URN de partage des publications partagées; string |
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/posts/comments" \
-H "Authorization: Bearer YOUR_API_KEY" \
--data-urlencode "urn=7267273010393358336"Créer une tâche de profil de membre
web_v2-create_user_profile_task
POST https://api.apihop.ai/v1/linkedin/web-v2/users/profile/tasks
Prix par requête réussie: $0.008 (8000 credits).
| Champ | Obligatoire | Contrat |
|---|---|---|
url | Oui | URL LinkedIn complète; string |
curl -X POST "https://api.apihop.ai/v1/linkedin/web-v2/users/profile/tasks" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.linkedin.com/in/williamhgates/"}'HTTP/1.1 202 Accepted
Location: /v1/linkedin/web-v2/tasks/3850699893338385742
Retry-After: 5
Content-Type: application/json
{"success":true,"data":{"id":"3850699893338385742","status":"PROCESSING","result":null},"requestId":"example-request"}Créer une tâche de profil d’entreprise
web_v2-create_company_profile_task
POST https://api.apihop.ai/v1/linkedin/web-v2/companies/profile/tasks
Prix par requête réussie: $0.008 (8000 credits).
| Champ | Obligatoire | Contrat |
|---|---|---|
url | Oui | URL LinkedIn complète; string |
curl -X POST "https://api.apihop.ai/v1/linkedin/web-v2/companies/profile/tasks" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.linkedin.com/company/microsoft/"}'HTTP/1.1 202 Accepted
Location: /v1/linkedin/web-v2/tasks/3850699893338385742
Retry-After: 5
Content-Type: application/json
{"success":true,"data":{"id":"3850699893338385742","status":"PROCESSING","result":null},"requestId":"example-request"}Créer une tâche de détails de publication
web_v2-create_post_detail_task
POST https://api.apihop.ai/v1/linkedin/web-v2/posts/detail/tasks
Prix par requête réussie: $0.008 (8000 credits).
| Champ | Obligatoire | Contrat |
|---|---|---|
url | Oui | URL LinkedIn complète; string |
curl -X POST "https://api.apihop.ai/v1/linkedin/web-v2/posts/detail/tasks" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.linkedin.com/posts/orlenchner_scrapecon-activity-7180537307521769472-oSYN"}'HTTP/1.1 202 Accepted
Location: /v1/linkedin/web-v2/tasks/3850699893338385742
Retry-After: 5
Content-Type: application/json
{"success":true,"data":{"id":"3850699893338385742","status":"PROCESSING","result":null},"requestId":"example-request"}Statut de la tâche
web_v2-get_task_status
GET https://api.apihop.ai/v1/linkedin/web-v2/tasks/:task_id
Prix par requête réussie: $0 (0 credits).
| Champ | Obligatoire | Contrat |
|---|---|---|
task_id | Oui | Identifiant de tâche de la plateforme dans le chemin URL ; chaîne décimale, pas un identifiant fournisseur; string; Identifiant entier exact |
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/tasks/397282151069614080" \
-H "Authorization: Bearer YOUR_API_KEY"HTTP/1.1 200 OK
Retry-After: 5
Content-Type: application/json
{"success":true,"data":{"id":"3850699893338385742","status":"PROCESSING"},"requestId":"example-request"}Résultat de la tâche
web_v2-get_task_result
GET https://api.apihop.ai/v1/linkedin/web-v2/tasks/:task_id/result
Prix par requête réussie: $0 (0 credits).
| Champ | Obligatoire | Contrat |
|---|---|---|
task_id | Oui | Identifiant de tâche de la plateforme dans le chemin URL ; chaîne décimale, pas un identifiant fournisseur; string; Identifiant entier exact |
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/tasks/397282151069614080/result" \
-H "Authorization: Bearer YOUR_API_KEY"HTTP/1.1 200 OK
Retry-After: 5
Content-Type: application/json
{"success":true,"data":{"id":"3850699893338385742","status":"PROCESSING","result":null},"requestId":"example-request"}{"success":true,"data":{"id":"3850699893338385742","status":"COMPLETED","result":{"records":[]}},"requestId":"example-request"}Réponses
Pour les opérations synchrones : L’enveloppe JSON native code/data et la précision numérique sont conservées. La structure varie selon l’opération. HTTP 200 ne suffit pas : les erreurs métier et les enregistrements d’erreur contenant error/error_code sont refusés. Les résultats vides réussis sont facturés. L’exemple est illustratif, pas un résultat de validation réelle.
{"code":200,"data":[]}Erreurs
HTTP 400 : paramètres invalides ; 401 : authentification invalide ; 402 : solde insuffisant ; 403 : accès à la passerelle refusé ; 405 : méthode non prise en charge ; 408 : annulation ; 429 : limitation de débit ; 502/503/504 : échec fournisseur, configuration indisponible ou délai dépassé. Conservez X-Request-Id pour le diagnostic.
Sources
Vérifié le 2026-10-31 avec l’OpenAPI officielle V5.3.2 et les tarifs actuels des endpoints. Ces sources décrivent le contrat et les prix, sans attester la réussite de tests réels pour chaque endpoint.