API dati LinkedIn | Documentazione 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 endpoint autenticati LinkedIn Web V2 offrono profili personali e aziendali, post, offerte di lavoro, ricerche e commenti.

Autenticazione

Invia la chiave API API Hop nell’intestazione Authorization. L’accesso dipende dai gateway attivi e dai permessi della chiave; la documentazione non conferma la disponibilità in produzione.

http

Authorization: Bearer YOUR_API_KEY

Richieste

Le operazioni sincrone usano GET con parametri di query e senza corpo. Campi sconosciuti e campi scalari ripetuti vengono rifiutati. Solo i campi array accettano chiavi ripetute, ad esempio company_ids=1035&company_ids=1441. Conserva identificatori e cursori come stringhe; non convertire identificatori grandi in numeri JavaScript. I valori facoltativi vuoti vengono omessi.

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

Fatturazione

Per le operazioni sincrone: Profili personali, profili aziendali e dettagli dei post costano $0.008 (8000 credits) per richiesta riuscita. Le altre cinque operazioni costano $0.05 (50000 credits). Sono prezzi predefiniti per i clienti; prevalgono i prezzi specifici dell’account. Ogni pagina richiesta viene fatturata separatamente, non ogni elemento. Gli errori del fornitore liberano la prenotazione; gli errori di contabilizzazione non generano un’altra chiamata.

Paginazione e limiti

Per le operazioni sincrone: I post personali restituiscono solo i 50 più recenti: start e pagination_token non hanno effetto, anche se la risposta contiene un token. I post aziendali usano start=0, 50, 100, ...; pagination_token non ha effetto. La ricerca di lavoro usa start=0, 25, 50, .... I commenti supportano page da 1 e pagination_token. Non ci sono paginazione o tentativi automatici; il timeout è di 60 secondi. La scarsità di risorse del fornitore può causare errori intermittenti.

Ambito

Sono disponibili otto operazioni sincrone Web V2 e cinque operazioni di task asincroni. Crea task per profili, aziende o post con POST e un campo JSON url. HTTP 202 restituisce un ID decimale del task della piattaforma come stringa. Le letture GET di stato e risultato sono gratuite e riservate allo stesso tenant; task sconosciuti, di altri tenant o prodotti restituiscono 404. Lo stato omette result; il risultato è null prima di COMPLETED. Il prezzo viene riservato alla creazione e addebitato una sola volta al successo ($0.008 / 8000 credits predefiniti). Un errore o un timeout di 30 minuti libera la riserva. Il controllo in background avviene ogni 5 secondi; le risposte in corso includono Retry-After: 5. I risultati sono memorizzati nel task della piattaforma. Non usare l’ID del fornitore. Un invio incerto non viene ripetuto automaticamente. Un task completato restituisce result.records. Gli interi oltre l’intervallo sicuro di JavaScript vengono salvati e restituiti come stringhe decimali. Gli esempi sono illustrativi, non risultati di verifica reale.

Riferimento completo

Risposte

Per le operazioni sincrone: La struttura JSON nativa code/data e la precisione numerica sono conservate. La struttura varia per operazione. HTTP 200 non basta: gli errori applicativi e i record di errore con error/error_code vengono rifiutati. I risultati vuoti riusciti sono fatturati. L’esempio è illustrativo, non è una verifica reale.

json

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

Errori

HTTP 400: parametri non validi; 401: autenticazione non valida; 402: saldo insufficiente; 403: accesso al gateway negato; 405: metodo non supportato; 408: annullamento; 429: limite di frequenza; 502/503/504: errore del fornitore, configurazione non disponibile o timeout. Conserva X-Request-Id per la diagnosi.

Fonti

Verificato il 2026-10-31 con l’OpenAPI ufficiale V5.3.2 e i prezzi correnti degli endpoint. Le fonti descrivono contratto e prezzi, ma non attestano test reali riusciti per tutti gli endpoint.

TikHub · OpenAPI · Prezzi