Documentazione API Hop
Riferimento degli endpoint LinkedIn
13 endpoint autenticati LinkedIn Web V2 offrono profili personali e aziendali, post, offerte di lavoro, ricerche e commenti.
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.
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.
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.
Profilo personale
web_v2-get_user_profile
GET https://api.apihop.ai/v1/linkedin/web-v2/users/profile
Prezzo per richiesta riuscita: $0.008 (8000 credits).
| Campo | Obbligatorio | Contratto |
|---|---|---|
url | Sì | URL LinkedIn completo; 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/"Post personali
web_v2-get_user_posts
GET https://api.apihop.ai/v1/linkedin/web-v2/users/posts
Prezzo per richiesta riuscita: $0.05 (50000 credits).
| Campo | Obbligatorio | Contratto |
|---|---|---|
url | Sì | URL LinkedIn completo; string |
type | No | Post propri, commentati o con reazioni; string; posts, comments, reactions; Valore predefinito: posts |
start | No | Offset; valgono i limiti dell’endpoint; integer; >= 0 |
pagination_token | No | Token di paginazione; valgono i limiti dell’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/"Profilo aziendale
web_v2-get_company_profile
GET https://api.apihop.ai/v1/linkedin/web-v2/companies/profile
Prezzo per richiesta riuscita: $0.008 (8000 credits).
| Campo | Obbligatorio | Contratto |
|---|---|---|
url | Sì | URL LinkedIn completo; 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/"Post aziendali
web_v2-get_company_posts
GET https://api.apihop.ai/v1/linkedin/web-v2/companies/posts
Prezzo per richiesta riuscita: $0.05 (50000 credits).
| Campo | Obbligatorio | Contratto |
|---|---|---|
url | Sì | URL LinkedIn completo; string |
start | No | Offset; valgono i limiti dell’endpoint; integer; >= 0 |
pagination_token | No | Token di paginazione; valgono i limiti dell’endpoint; string |
sort_by | No | Ordinamento; 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/"Dettagli dell’offerta
web_v2-get_job_detail
GET https://api.apihop.ai/v1/linkedin/web-v2/jobs/detail
Prezzo per richiesta riuscita: $0.05 (50000 credits).
| Campo | Obbligatorio | Contratto |
|---|---|---|
url | Sì | URL LinkedIn completo; string |
include_skills | No | Includi competenze richieste; boolean; Valore predefinito: false |
include_hiring_team | No | Includi team di selezione; boolean; Valore predefinito: 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/"Ricerca di lavoro
web_v2-search_jobs
GET https://api.apihop.ai/v1/linkedin/web-v2/jobs/search
Prezzo per richiesta riuscita: $0.05 (50000 credits).
| Campo | Obbligatorio | Contratto |
|---|---|---|
keywords | No | Parole chiave; string |
geo_code | No | ID geografico; 92000000 indica tutto il mondo; integer; Identificatore intero esatto |
date_posted | No | Filtro per data di pubblicazione; string; Any time, Past month, Past week, Past 24 hours |
experience_levels | No | Livelli di esperienza; string[]; Chiave di query ripetuta; Internship, Entry level, Associate, Mid-Senior level, Director, Executive |
company_ids | No | ID delle aziende; integer[]; Chiave di query ripetuta; Identificatore intero esatto |
title_ids | No | ID dei titoli professionali; integer[]; Chiave di query ripetuta; Identificatore intero esatto |
onsite_remotes | No | Tipi di luogo di lavoro; string[]; Chiave di query ripetuta; On-site, Remote, Hybrid |
functions | No | Funzioni lavorative; string[]; Chiave di query ripetuta |
industries | No | Settori; string[]; Chiave di query ripetuta |
job_types | No | Tipi di impiego; string[]; Chiave di query ripetuta; Full-time, Part-time, Contract, Temporary, Internship, Volunteer |
sort_by | No | Ordinamento; string; Most relevant, Most recent |
easy_apply | No | Solo candidatura semplice; boolean; Valore predefinito: false |
under_10_applicants | No | Solo meno di 10 candidati; boolean; Valore predefinito: false |
start | No | Offset; valgono i limiti dell’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"Dettagli del post
web_v2-get_post_detail
GET https://api.apihop.ai/v1/linkedin/web-v2/posts/detail
Prezzo per richiesta riuscita: $0.008 (8000 credits).
| Campo | Obbligatorio | Contratto |
|---|---|---|
url | Sì | URL LinkedIn completo; 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"Commenti del post
web_v2-get_post_comments
GET https://api.apihop.ai/v1/linkedin/web-v2/posts/comments
Prezzo per richiesta riuscita: $0.05 (50000 credits).
| Campo | Obbligatorio | Contratto |
|---|---|---|
urn | Sì | URN di attività del post; string |
sort_by | No | Ordinamento; string; Most relevant, Most recent |
page | No | Numero di pagina da 1; integer; >= 1 |
pagination_token | No | Token di paginazione; valgono i limiti dell’endpoint; string |
share_urn | No | URN di condivisione dei post condivisi; string |
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/posts/comments" \
-H "Authorization: Bearer YOUR_API_KEY" \
--data-urlencode "urn=7267273010393358336"Crea task per profilo personale
web_v2-create_user_profile_task
POST https://api.apihop.ai/v1/linkedin/web-v2/users/profile/tasks
Prezzo per richiesta riuscita: $0.008 (8000 credits).
| Campo | Obbligatorio | Contratto |
|---|---|---|
url | Sì | URL LinkedIn completo; 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"}Crea task per profilo aziendale
web_v2-create_company_profile_task
POST https://api.apihop.ai/v1/linkedin/web-v2/companies/profile/tasks
Prezzo per richiesta riuscita: $0.008 (8000 credits).
| Campo | Obbligatorio | Contratto |
|---|---|---|
url | Sì | URL LinkedIn completo; 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"}Crea task per dettagli del post
web_v2-create_post_detail_task
POST https://api.apihop.ai/v1/linkedin/web-v2/posts/detail/tasks
Prezzo per richiesta riuscita: $0.008 (8000 credits).
| Campo | Obbligatorio | Contratto |
|---|---|---|
url | Sì | URL LinkedIn completo; 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"}Stato del task
web_v2-get_task_status
GET https://api.apihop.ai/v1/linkedin/web-v2/tasks/:task_id
Prezzo per richiesta riuscita: $0 (0 credits).
| Campo | Obbligatorio | Contratto |
|---|---|---|
task_id | Sì | ID del task della piattaforma nel percorso URL; stringa decimale, non ID del fornitore; string; Identificatore intero esatto |
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"}Risultato del task
web_v2-get_task_result
GET https://api.apihop.ai/v1/linkedin/web-v2/tasks/:task_id/result
Prezzo per richiesta riuscita: $0 (0 credits).
| Campo | Obbligatorio | Contratto |
|---|---|---|
task_id | Sì | ID del task della piattaforma nel percorso URL; stringa decimale, non ID del fornitore; string; Identificatore intero esatto |
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"}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.
{"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.