LinkedIn データ API | 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 のの LinkedIn Web V2 エンドポイントで、会員・企業プロフィール、投稿、求人情報、求人検索結果、コメントを取得します。

認証

Authorization ヘッダーに API Hop API キーを指定してください。利用可否は有効なゲートウェイとキーの権限に依存し、この文書は本番環境での提供を保証しません。

http

Authorization: Bearer YOUR_API_KEY

リクエスト

同期操作は本文なしの GET クエリパラメーターを使用します。未知のフィールドとスカラー値の重複は拒否されます。配列と記載されたフィールドのみ、company_ids=1035&company_ids=1441 のように同じキーを繰り返せます。ID とカーソルは文字列で保持し、大きな ID を JavaScript の数値に変換しないでください。任意項目の空値は省略されます。

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

課金

同期操作：会員プロフィール、企業プロフィール、投稿詳細は成功したリクエストごとに $0.008（8000 credits）、ほかの 5 操作は $0.05（50000 credits）です。これは標準の顧客料金で、アカウント固有の料金が優先されます。返却件数ではなく、取得したページごとに課金します。上流の失敗時は予約額を解放し、精算エラー時は上流へ再送しません。

ページングと制限

同期操作：会員の投稿は最新 50 件のみです。応答にトークンが含まれていても、start と pagination_token は無効です。企業の投稿は start=0, 50, 100, ... を使用し、pagination_token は無効です。求人検索は start=0, 25, 50, ... を使用します。コメントは 1 から始まる page と pagination_token に対応します。自動ページングと自動再試行は行わず、タイムアウトは 60 秒です。供給元のリソース不足で一時的な失敗が生じる場合があります。

対象範囲

Web V2 の同期操作 8 件と非同期タスク操作 5 件を提供します。url を含む JSON を POST して会員プロフィール、企業プロフィール、投稿詳細のタスクを作成します。HTTP 202 と文字列のプラットフォーム十進数タスク ID を返します。状態と結果の GET は同じテナントのみ無料で利用できます。不明なタスク、別テナントや別製品のタスクは 404 です。状態には result を含めず、COMPLETED 前の結果は null です。作成時に料金を確保し、成功時に一度だけ精算します（標準 $0.008 / 8000 credits）。失敗または 30 分のタイムアウトで確保分を解放します。バックグラウンドで 5 秒ごとに確認し、処理中の応答には Retry-After: 5 を含めます。結果はプラットフォームのタスクに保存されます。供給元の ID は使用できません。送信結果が不明な場合は自動再送しません。完了したタスクのデータは result.records に格納されます。JavaScript の安全な整数範囲を超える値は十進数の文字列として保存・返却します。例は説明用であり、実際の検証結果ではありません。

完全なリファレンス

レスポンス

同期操作：元の JSON の code/data 構造と数値精度を保持します。応答構造は操作ごとに異なります。HTTP 200 だけでは成功と判断せず、業務エラーや error/error_code を含むエラーレコードは拒否します。成功した空の結果は課金対象です。以下は説明用の例であり、実際の検証結果ではありません。

json

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

エラー

HTTP 400：不正なパラメーター、401：認証失敗、402：残高不足、403：ゲートウェイへのアクセス拒否、405：未対応のメソッド、408：キャンセル、429：レート制限、502/503/504：供給元の障害・設定の利用不可・タイムアウト。調査のため X-Request-Id を保存してください。

出典

2026-10-31 に公式 OpenAPI V5.3.2 と現在のエンドポイント料金を照合しました。出典は仕様と価格を示すもので、全エンドポイントの実呼び出し成功を証明するものではありません。

TikHub · OpenAPI · 料金