API Hop

Documentation

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

ChampObligatoireContrat
urlOuiURL LinkedIn complète; string
bash
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).

ChampObligatoireContrat
urlOuiURL LinkedIn complète; string
typeNonPublications, publications commentées ou ayant reçu une réaction; string; posts, comments, reactions; Valeur par défaut: posts
startNonDécalage ; respecter les limites de l’endpoint; integer; >= 0
pagination_tokenNonJeton de pagination ; respecter les limites de l’endpoint; string
bash
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).

ChampObligatoireContrat
urlOuiURL LinkedIn complète; string
bash
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).

ChampObligatoireContrat
urlOuiURL LinkedIn complète; string
startNonDécalage ; respecter les limites de l’endpoint; integer; >= 0
pagination_tokenNonJeton de pagination ; respecter les limites de l’endpoint; string
sort_byNonOrdre de tri; string; top, recent
bash
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).

ChampObligatoireContrat
urlOuiURL LinkedIn complète; string
include_skillsNonInclure les compétences requises; boolean; Valeur par défaut: false
include_hiring_teamNonInclure l’équipe de recrutement; boolean; Valeur par défaut: false
bash
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/"

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

ChampObligatoireContrat
keywordsNonMots-clés de recherche; string
geo_codeNonIdentifiant géographique ; 92000000 signifie le monde entier; integer; Identifiant entier exact
date_postedNonFiltre de date de publication; string; Any time, Past month, Past week, Past 24 hours
experience_levelsNonNiveaux d’expérience; string[]; Clé de requête répétée; Internship, Entry level, Associate, Mid-Senior level, Director, Executive
company_idsNonIdentifiants d’entreprises; integer[]; Clé de requête répétée; Identifiant entier exact
title_idsNonIdentifiants d’intitulés de poste; integer[]; Clé de requête répétée; Identifiant entier exact
onsite_remotesNonTypes de lieu de travail; string[]; Clé de requête répétée; On-site, Remote, Hybrid
functionsNonFonctions; string[]; Clé de requête répétée
industriesNonSecteurs; string[]; Clé de requête répétée
job_typesNonTypes de contrat; string[]; Clé de requête répétée; Full-time, Part-time, Contract, Temporary, Internship, Volunteer
sort_byNonOrdre de tri; string; Most relevant, Most recent
easy_applyNonCandidature simplifiée uniquement; boolean; Valeur par défaut: false
under_10_applicantsNonMoins de 10 candidats uniquement; boolean; Valeur par défaut: false
startNonDécalage ; respecter les limites de l’endpoint; integer; >= 0
bash
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).

ChampObligatoireContrat
urlOuiURL LinkedIn complète; string
bash
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).

ChampObligatoireContrat
urnOuiURN d’activité de la publication; string
sort_byNonOrdre de tri; string; Most relevant, Most recent
pageNonNuméro de page à partir de 1; integer; >= 1
pagination_tokenNonJeton de pagination ; respecter les limites de l’endpoint; string
share_urnNonURN de partage des publications partagées; string
bash
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).

ChampObligatoireContrat
urlOuiURL LinkedIn complète; string
bash
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
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).

ChampObligatoireContrat
urlOuiURL LinkedIn complète; string
bash
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
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).

ChampObligatoireContrat
urlOuiURL LinkedIn complète; string
bash
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
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).

ChampObligatoireContrat
task_idOuiIdentifiant de tâche de la plateforme dans le chemin URL ; chaîne décimale, pas un identifiant fournisseur; string; Identifiant entier exact
bash
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/tasks/397282151069614080" \
  -H "Authorization: Bearer YOUR_API_KEY"
http
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).

ChampObligatoireContrat
task_idOuiIdentifiant de tâche de la plateforme dans le chemin URL ; chaîne décimale, pas un identifiant fournisseur; string; Identifiant entier exact
bash
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/tasks/397282151069614080/result" \
  -H "Authorization: Bearer YOUR_API_KEY"
http
HTTP/1.1 200 OK
Retry-After: 5
Content-Type: application/json

{"success":true,"data":{"id":"3850699893338385742","status":"PROCESSING","result":null},"requestId":"example-request"}
json
{"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.

json
{"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.

TikHub · OpenAPI · Tarifs