LinkedIn-Daten-API | API-Dokumentation

# 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 authentifizierte LinkedIn-Web-V2-Endpunkte liefern Mitglieder- und Unternehmensprofile, Beiträge, Stellenangebote, Stellensuchen und Kommentare.

Authentifizierung

Senden Sie Ihren API Hop-API-Schlüssel im Authorization-Header. Der Zugriff hängt von aktivierten Gateways und Schlüsselberechtigungen ab; die Dokumentation bestätigt keine Produktionsfreigabe.

http

Authorization: Bearer YOUR_API_KEY

Anfragen

Synchrone Vorgänge verwenden GET-Abfrageparameter ohne Anfragekörper. Unbekannte Felder und doppelte skalare Felder werden abgelehnt. Nur als Arrays markierte Felder erlauben wiederholte Schlüssel, etwa company_ids=1035&company_ids=1441. IDs und Cursor bleiben Zeichenfolgen; große IDs dürfen nicht in JavaScript-Zahlen umgewandelt werden. Optionale leere Werte werden ausgelassen.

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

Abrechnung

Für synchrone Vorgänge: Mitgliederprofile, Unternehmensprofile und Beitragsdetails kosten $0.008 (8000 credits) je erfolgreicher Anfrage. Die anderen fünf Vorgänge kosten $0.05 (50000 credits). Dies sind Standardkundenpreise; individuelle Kontopreise haben Vorrang. Jede angeforderte Seite wird separat berechnet, nicht jeder Datensatz. Anbieterfehler geben die Reservierung frei; Abrechnungsfehler lösen keinen weiteren Anbieteraufruf aus.

Seitennavigation und Grenzen

Für synchrone Vorgänge: Mitgliederbeiträge liefern nur die neuesten 50 Einträge: start und pagination_token bleiben wirkungslos, auch wenn die Antwort einen Token enthält. Unternehmensbeiträge verwenden start=0, 50, 100, ...; pagination_token hat keine Wirkung. Stellensuchen verwenden start=0, 25, 50, .... Kommentare unterstützen page ab 1 und pagination_token. Es gibt weder automatische Seitennavigation noch automatische Wiederholungen; das Zeitlimit beträgt 60 Sekunden. Ressourcenengpässe beim Anbieter können zeitweise Fehler verursachen.

Umfang

Verfügbar sind acht synchrone Web-V2-Vorgänge und fünf asynchrone Aufgabenvorgänge. Profil-, Unternehmens- und Beitragsaufgaben werden mit POST und einem JSON-Feld url erstellt. HTTP 202 liefert eine dezimale Plattform-Aufgaben-ID als Zeichenfolge. GET-Abfragen von Status und Ergebnis sind kostenlos und auf denselben Mandanten beschränkt; unbekannte, fremde oder produktfremde Aufgaben liefern 404. Status enthält kein result; vor COMPLETED ist das Ergebnis null. Der Preis wird bei Erstellung reserviert und bei Erfolg einmal berechnet (standardmäßig $0.008 / 8000 credits). Fehler oder 30 Minuten Zeitüberschreitung geben die Reservierung frei. Hintergrundabfragen erfolgen alle 5 Sekunden; laufende Antworten enthalten Retry-After: 5. Ergebnisse werden in der Plattformaufgabe gespeichert. Verwenden Sie keine Anbieter-ID. Ungewisse Übermittlungen werden nicht automatisch wiederholt. Abgeschlossene Aufgaben liefern result.records. Ganzzahlen außerhalb des sicheren JavaScript-Bereichs werden als dezimale Zeichenfolgen gespeichert und zurückgegeben. Beispiele sind keine Live-Abnahmeergebnisse.

Vollständige Referenz

Antworten

Für synchrone Vorgänge: Die ursprüngliche JSON-Struktur code/data und Zahlengenauigkeit bleiben erhalten. Antwortstrukturen unterscheiden sich je Vorgang. HTTP 200 allein bedeutet keinen Erfolg: Anwendungsfehler und Fehlerdatensätze mit error/error_code werden abgelehnt. Erfolgreiche leere Ergebnisse werden berechnet. Das Beispiel ist keine reale Abnahmeantwort.

json

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

Fehler

HTTP 400: ungültige Parameter; 401: ungültige Authentifizierung; 402: unzureichendes Guthaben; 403: Gateway-Zugriff verweigert; 405: Methode nicht unterstützt; 408: Abbruch; 429: Ratenbegrenzung; 502/503/504: Anbieterfehler, fehlende Konfiguration oder Zeitüberschreitung. Bewahren Sie X-Request-Id für die Fehleranalyse auf.

Quellen

Am 2026-10-31 mit der offiziellen OpenAPI V5.3.2 und aktuellen Endpunktpreisen abgeglichen. Diese Quellen belegen Vertrag und Preise, nicht erfolgreiche Live-Tests aller Endpunkte.

TikHub · OpenAPI · Preise