API Hop

Documentazione

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

CampoObbligatorioContratto
urlSìURL LinkedIn completo; 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/"

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

CampoObbligatorioContratto
urlSìURL LinkedIn completo; string
typeNoPost propri, commentati o con reazioni; string; posts, comments, reactions; Valore predefinito: posts
startNoOffset; valgono i limiti dell’endpoint; integer; >= 0
pagination_tokenNoToken di paginazione; valgono i limiti dell’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/"

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

CampoObbligatorioContratto
urlSìURL LinkedIn completo; 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/"

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

CampoObbligatorioContratto
urlSìURL LinkedIn completo; string
startNoOffset; valgono i limiti dell’endpoint; integer; >= 0
pagination_tokenNoToken di paginazione; valgono i limiti dell’endpoint; string
sort_byNoOrdinamento; 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/"

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

CampoObbligatorioContratto
urlSìURL LinkedIn completo; string
include_skillsNoIncludi competenze richieste; boolean; Valore predefinito: false
include_hiring_teamNoIncludi team di selezione; boolean; Valore predefinito: 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

Prezzo per richiesta riuscita: $0.05 (50000 credits).

CampoObbligatorioContratto
keywordsNoParole chiave; string
geo_codeNoID geografico; 92000000 indica tutto il mondo; integer; Identificatore intero esatto
date_postedNoFiltro per data di pubblicazione; string; Any time, Past month, Past week, Past 24 hours
experience_levelsNoLivelli di esperienza; string[]; Chiave di query ripetuta; Internship, Entry level, Associate, Mid-Senior level, Director, Executive
company_idsNoID delle aziende; integer[]; Chiave di query ripetuta; Identificatore intero esatto
title_idsNoID dei titoli professionali; integer[]; Chiave di query ripetuta; Identificatore intero esatto
onsite_remotesNoTipi di luogo di lavoro; string[]; Chiave di query ripetuta; On-site, Remote, Hybrid
functionsNoFunzioni lavorative; string[]; Chiave di query ripetuta
industriesNoSettori; string[]; Chiave di query ripetuta
job_typesNoTipi di impiego; string[]; Chiave di query ripetuta; Full-time, Part-time, Contract, Temporary, Internship, Volunteer
sort_byNoOrdinamento; string; Most relevant, Most recent
easy_applyNoSolo candidatura semplice; boolean; Valore predefinito: false
under_10_applicantsNoSolo meno di 10 candidati; boolean; Valore predefinito: false
startNoOffset; valgono i limiti dell’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"

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

CampoObbligatorioContratto
urlSìURL LinkedIn completo; 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"

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

CampoObbligatorioContratto
urnSìURN di attività del post; string
sort_byNoOrdinamento; string; Most relevant, Most recent
pageNoNumero di pagina da 1; integer; >= 1
pagination_tokenNoToken di paginazione; valgono i limiti dell’endpoint; string
share_urnNoURN di condivisione dei post condivisi; string
bash
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).

CampoObbligatorioContratto
urlSìURL LinkedIn completo; 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"}

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

CampoObbligatorioContratto
urlSìURL LinkedIn completo; 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"}

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

CampoObbligatorioContratto
urlSìURL LinkedIn completo; 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"}

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

CampoObbligatorioContratto
task_idSìID del task della piattaforma nel percorso URL; stringa decimale, non ID del fornitore; string; Identificatore intero esatto
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"}

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

CampoObbligatorioContratto
task_idSìID del task della piattaforma nel percorso URL; stringa decimale, non ID del fornitore; string; Identificatore intero esatto
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"}

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