API de données LinkedIn | Documentation des API

# LinkedIn Data API

Read member and company profiles, posts, job details, job search results, and comments through 13 authenticated LinkedIn Web V2 endpoints.

## Authentication

Send your API Hop API key in the Authorization header. Access depends on enabled gateways and your key permissions; documentation does not confirm production availability.

```http
Authorization: Bearer YOUR_API_KEY
```

## Requests

Synchronous operations use GET query parameters without a body. Unknown fields and duplicate scalar fields are rejected. Only fields marked as arrays accept repeated keys, for example company_ids=1035&company_ids=1441. Preserve IDs and cursors as strings; do not convert large identifiers to JavaScript numbers. Optional empty values are omitted.

```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/"
```

## Billing

For synchronous operations: Member profiles, company profiles, and post details cost $0.008 (8000 credits) per successful request. The other five operations cost $0.05 (50000 credits). These are default customer prices; account-specific prices take precedence. Every requested page is billed separately, not per item. Upstream failures release the reservation. Settlement failures do not trigger another upstream call.

## Pagination and limits

For synchronous operations: Member posts return only the latest 50 items: start and pagination_token have no effect, even when the response contains a token. Company posts use start=0, 50, 100, ...; pagination_token has no effect. Job search uses start=0, 25, 50, .... Comments support page (starting at 1) and pagination_token. There is no automatic pagination. Requests time out after 60 seconds with no automatic retries. The supplier warns that resource constraints can cause intermittent failures.

## Scope

Eight synchronous Web V2 operations and five asynchronous task operations are available. Create profile, company, or post tasks with POST and a JSON url field. Creation returns HTTP 202 and a decimal platform task ID as a string. GET status and result reads require the same tenant and are free; unknown, foreign-tenant, and other-product tasks return 404. Status omits result; result is null before COMPLETED. Each task reserves its price at creation and charges once on success ($0.008 / 8000 credits by default). Failure or a 30-minute timeout releases the reservation. Background polling runs every 5 seconds; pending responses include Retry-After: 5. Results are stored in the platform job. Use the platform ID, never a supplier task ID. An uncertain submission is not automatically repeated. A completed task returns result.records. Integers beyond the JavaScript safe range are stored and returned as decimal strings. Examples are illustrative, not live acceptance results.

[Complete reference](https://apihop.ai/en/docs/api-reference/linkedin/reference)

## Responses

For synchronous operations: The native JSON code/data envelope and numeric precision are preserved. Response shapes vary by operation. HTTP 200 alone is not success: business errors, including error/error_code records, are rejected. A successful empty result is billable. This is an illustrative response, not a live acceptance result.

```json
{"code":200,"data":[]}
```

## Errors

HTTP 400: invalid parameters; 401: invalid authentication; 402: insufficient credit; 403: denied gateway access; 405: unsupported method; 408: cancellation; 429: rate limit; 502/503/504: supplier failure, unavailable configuration, or timeout. Keep X-Request-Id for troubleshooting.

## Sources

Checked on 2026-10-31 against the official OpenAPI V5.3.2 and current endpoint prices. These sources describe the contract and prices, not successful live verification of every endpoint.

[TikHub](https://docs.tikhub.io/4592766m0) · [OpenAPI](https://api.tikhub.io/openapi.json) · [Prices](https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info)

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.

http

Authorization: Bearer YOUR_API_KEY

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.

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/"

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.

Référence complète

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