LinkedIn: API danych | Dokumentacja 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)

Odczytuj profile członków i firm, posty, szczegóły ofert pracy, wyniki wyszukiwania ofert i komentarze przez 13 uwierzytelnionych punktów końcowych LinkedIn Web V2.

Uwierzytelnianie

Wyślij klucz API API Hop w nagłówku Authorization. Dostęp zależy od włączonych bram i uprawnień klucza; dokumentacja nie potwierdza dostępności produkcyjnej.

http

Authorization: Bearer YOUR_API_KEY

Żądania

Operacje synchroniczne używają parametrów zapytania GET bez treści. Nieznane pola i zdublowane pola skalarne są odrzucane. Tylko pola oznaczone jako tablice akceptują powtarzane klucze, na przykład company_ids=1035&company_ids=1441. Zachowuj ID i kursory jako ciągi znaków; nie konwertuj dużych identyfikatorów na liczby JavaScript. Opcjonalne puste wartości są pomijane.

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

Rozliczenia

Dla operacji synchronicznych: profile członków, profile firm i szczegóły postów kosztują $0.008 (8000 kredytów) za udane żądanie. Pozostałe pięć operacji kosztuje $0.05 (50000 kredytów). To domyślne ceny klienta; pierwszeństwo mają ceny indywidualne konta. Każda żądana strona jest rozliczana osobno, a nie według liczby pozycji. Błędy dostawcy zwalniają rezerwację. Błędy rozliczenia nie wywołują kolejnego wywołania dostawcy.

Stronicowanie i limity

Dla operacji synchronicznych: posty członka zwracają tylko ostatnie 50 pozycji: start i pagination_token nie działają, nawet gdy odpowiedź zawiera token. Posty firmy używają start=0, 50, 100, ...; pagination_token nie działa. Wyszukiwanie ofert używa start=0, 25, 50, .... Komentarze obsługują page (od 1) i pagination_token. Nie ma automatycznego stronicowania. Żądania przekraczają limit po 60 sekundach bez automatycznych ponowień. Dostawca ostrzega, że ograniczenia zasobów mogą powodować sporadyczne błędy.

Zakres

Dostępnych jest osiem synchronicznych operacji Web V2 i pięć asynchronicznych operacji zadań. Twórz zadania profilu, firmy lub posta przez POST i pole url w JSON. Utworzenie zwraca HTTP 202 i dziesiętny identyfikator zadania platformy jako ciąg znaków. Odczyty statusu i wyniku przez GET wymagają tego samego najemcy i są bezpłatne; zadania nieznane, innego najemcy lub produktu zwracają 404. Status pomija result; result ma wartość null przed COMPLETED. Każde zadanie rezerwuje cenę przy utworzeniu i pobiera opłatę raz po sukcesie (domyślnie $0.008 / 8000 kredytów). Błąd lub limit 30 minut zwalnia rezerwację. Odpytywanie w tle działa co 5 sekund; odpowiedzi oczekujące zawierają Retry-After: 5. Wyniki są zapisane w zadaniu platformy. Używaj ID platformy, nigdy ID zadania dostawcy. Niepewne zgłoszenie nie jest automatycznie powtarzane. Ukończone zadanie zwraca result.records. Liczby całkowite poza bezpiecznym zakresem JavaScript są zapisywane i zwracane jako ciągi dziesiętne. Przykłady są ilustracyjne, a nie wynikami akceptacji na żywo.

Pełny opis punktów końcowych

Odpowiedzi

Dla operacji synchronicznych: natywne opakowanie JSON code/data i precyzja liczb zostają zachowane. Struktury odpowiedzi zależą od operacji. Sam HTTP 200 nie jest sukcesem: błędy biznesowe, w tym rekordy error/error_code, są odrzucane. Udany pusty wynik podlega opłacie. To odpowiedź ilustracyjna, a nie wynik akceptacji na żywo.

json

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

Błędy

HTTP 400: nieprawidłowe parametry; 401: nieprawidłowe uwierzytelnienie; 402: niewystarczające środki; 403: odmowa dostępu do bramy; 405: nieobsługiwana metoda; 408: anulowanie; 429: limit częstotliwości; 502/503/504: błąd dostawcy, niedostępna konfiguracja lub limit czasu. Zachowaj X-Request-Id do diagnozy.

Źródła

Sprawdzono 2026-10-31 względem oficjalnego OpenAPI V5.3.2 i aktualnych cen punktów końcowych. Źródła opisują kontrakt i ceny, a nie udaną weryfikację każdego punktu końcowego na żywo.

TikHub · OpenAPI · Ceny