API Hop ドキュメント
LinkedIn エンドポイントリファレンス
認証付きの 13 のの LinkedIn Web V2 エンドポイントで、会員・企業プロフィール、投稿、求人情報、求人検索結果、コメントを取得します。
認証付きの 13 のの LinkedIn Web V2 エンドポイントで、会員・企業プロフィール、投稿、求人情報、求人検索結果、コメントを取得します。
認証
Authorization ヘッダーに API Hop API キーを指定してください。利用可否は有効なゲートウェイとキーの権限に依存し、この文書は本番環境での提供を保証しません。
リクエスト
同期操作は本文なしの GET クエリパラメーターを使用します。未知のフィールドとスカラー値の重複は拒否されます。配列と記載されたフィールドのみ、company_ids=1035&company_ids=1441 のように同じキーを繰り返せます。ID とカーソルは文字列で保持し、大きな ID を JavaScript の数値に変換しないでください。任意項目の空値は省略されます。
課金
同期操作:会員プロフィール、企業プロフィール、投稿詳細は成功したリクエストごとに $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 の安全な整数範囲を超える値は十進数の文字列として保存・返却します。例は説明用であり、実際の検証結果ではありません。
会員プロフィール
web_v2-get_user_profile
GET https://api.apihop.ai/v1/linkedin/web-v2/users/profile
成功したリクエストごとの料金: $0.008 (8000 credits).
| フィールド | 必須 | 仕様 |
|---|---|---|
url | はい | 完全な LinkedIn URL; 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/"会員の投稿
web_v2-get_user_posts
GET https://api.apihop.ai/v1/linkedin/web-v2/users/posts
成功したリクエストごとの料金: $0.05 (50000 credits).
| フィールド | 必須 | 仕様 |
|---|---|---|
url | はい | 完全な LinkedIn URL; string |
type | いいえ | 投稿・コメントした投稿・リアクションした投稿; string; posts, comments, reactions; 既定値: posts |
start | いいえ | オフセット。各エンドポイントの制限に従う; integer; >= 0 |
pagination_token | いいえ | ページングトークン。各エンドポイントの制限に従う; 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/"企業プロフィール
web_v2-get_company_profile
GET https://api.apihop.ai/v1/linkedin/web-v2/companies/profile
成功したリクエストごとの料金: $0.008 (8000 credits).
| フィールド | 必須 | 仕様 |
|---|---|---|
url | はい | 完全な LinkedIn URL; 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/"企業の投稿
web_v2-get_company_posts
GET https://api.apihop.ai/v1/linkedin/web-v2/companies/posts
成功したリクエストごとの料金: $0.05 (50000 credits).
| フィールド | 必須 | 仕様 |
|---|---|---|
url | はい | 完全な LinkedIn URL; string |
start | いいえ | オフセット。各エンドポイントの制限に従う; integer; >= 0 |
pagination_token | いいえ | ページングトークン。各エンドポイントの制限に従う; string |
sort_by | いいえ | 並び順; 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/"求人詳細
web_v2-get_job_detail
GET https://api.apihop.ai/v1/linkedin/web-v2/jobs/detail
成功したリクエストごとの料金: $0.05 (50000 credits).
| フィールド | 必須 | 仕様 |
|---|---|---|
url | はい | 完全な LinkedIn URL; string |
include_skills | いいえ | 必要なスキルを含める; boolean; 既定値: false |
include_hiring_team | いいえ | 採用チームを含める; boolean; 既定値: 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/"求人検索
web_v2-search_jobs
GET https://api.apihop.ai/v1/linkedin/web-v2/jobs/search
成功したリクエストごとの料金: $0.05 (50000 credits).
| フィールド | 必須 | 仕様 |
|---|---|---|
keywords | いいえ | 検索キーワード; string |
geo_code | いいえ | 地域 ID。92000000 は全世界; integer; 精度を保持する整数 ID |
date_posted | いいえ | 掲載日フィルター; string; Any time, Past month, Past week, Past 24 hours |
experience_levels | いいえ | 経験レベル; string[]; 同じクエリキーを繰り返す; Internship, Entry level, Associate, Mid-Senior level, Director, Executive |
company_ids | いいえ | 企業 ID; integer[]; 同じクエリキーを繰り返す; 精度を保持する整数 ID |
title_ids | いいえ | 職種名 ID; integer[]; 同じクエリキーを繰り返す; 精度を保持する整数 ID |
onsite_remotes | いいえ | 勤務場所の種類; string[]; 同じクエリキーを繰り返す; On-site, Remote, Hybrid |
functions | いいえ | 職務; string[]; 同じクエリキーを繰り返す |
industries | いいえ | 業界; string[]; 同じクエリキーを繰り返す |
job_types | いいえ | 雇用形態; string[]; 同じクエリキーを繰り返す; Full-time, Part-time, Contract, Temporary, Internship, Volunteer |
sort_by | いいえ | 並び順; string; Most relevant, Most recent |
easy_apply | いいえ | 簡単応募のみ; boolean; 既定値: false |
under_10_applicants | いいえ | 応募者が 10 人未満の求人のみ; boolean; 既定値: false |
start | いいえ | オフセット。各エンドポイントの制限に従う; 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"投稿詳細
web_v2-get_post_detail
GET https://api.apihop.ai/v1/linkedin/web-v2/posts/detail
成功したリクエストごとの料金: $0.008 (8000 credits).
| フィールド | 必須 | 仕様 |
|---|---|---|
url | はい | 完全な LinkedIn URL; 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"投稿コメント
web_v2-get_post_comments
GET https://api.apihop.ai/v1/linkedin/web-v2/posts/comments
成功したリクエストごとの料金: $0.05 (50000 credits).
| フィールド | 必須 | 仕様 |
|---|---|---|
urn | はい | 投稿の activity URN; string |
sort_by | いいえ | 並び順; string; Most relevant, Most recent |
page | いいえ | 1 から始まるページ番号; integer; >= 1 |
pagination_token | いいえ | ページングトークン。各エンドポイントの制限に従う; string |
share_urn | いいえ | 共有投稿の share URN; string |
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/posts/comments" \
-H "Authorization: Bearer YOUR_API_KEY" \
--data-urlencode "urn=7267273010393358336"会員プロフィールタスクを作成
web_v2-create_user_profile_task
POST https://api.apihop.ai/v1/linkedin/web-v2/users/profile/tasks
成功したリクエストごとの料金: $0.008 (8000 credits).
| フィールド | 必須 | 仕様 |
|---|---|---|
url | はい | 完全な LinkedIn URL; 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"}企業プロフィールタスクを作成
web_v2-create_company_profile_task
POST https://api.apihop.ai/v1/linkedin/web-v2/companies/profile/tasks
成功したリクエストごとの料金: $0.008 (8000 credits).
| フィールド | 必須 | 仕様 |
|---|---|---|
url | はい | 完全な LinkedIn URL; 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"}投稿詳細タスクを作成
web_v2-create_post_detail_task
POST https://api.apihop.ai/v1/linkedin/web-v2/posts/detail/tasks
成功したリクエストごとの料金: $0.008 (8000 credits).
| フィールド | 必須 | 仕様 |
|---|---|---|
url | はい | 完全な LinkedIn URL; 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"}タスクの状態
web_v2-get_task_status
GET https://api.apihop.ai/v1/linkedin/web-v2/tasks/:task_id
成功したリクエストごとの料金: $0 (0 credits).
| フィールド | 必須 | 仕様 |
|---|---|---|
task_id | はい | URL パスのプラットフォームタスク ID。十進数の文字列で指定し、供給元の ID は使用不可; string; 精度を保持する整数 ID |
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"}タスクの結果
web_v2-get_task_result
GET https://api.apihop.ai/v1/linkedin/web-v2/tasks/:task_id/result
成功したリクエストごとの料金: $0 (0 credits).
| フィールド | 必須 | 仕様 |
|---|---|---|
task_id | はい | URL パスのプラットフォームタスク ID。十進数の文字列で指定し、供給元の ID は使用不可; string; 精度を保持する整数 ID |
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"}レスポンス
同期操作:元の JSON の code/data 構造と数値精度を保持します。応答構造は操作ごとに異なります。HTTP 200 だけでは成功と判断せず、業務エラーや error/error_code を含むエラーレコードは拒否します。成功した空の結果は課金対象です。以下は説明用の例であり、実際の検証結果ではありません。
{"code":200,"data":[]}エラー
HTTP 400:不正なパラメーター、401:認証失敗、402:残高不足、403:ゲートウェイへのアクセス拒否、405:未対応のメソッド、408:キャンセル、429:レート制限、502/503/504:供給元の障害・設定の利用不可・タイムアウト。調査のため X-Request-Id を保存してください。
出典
2026-10-31 に公式 OpenAPI V5.3.2 と現在のエンドポイント料金を照合しました。出典は仕様と価格を示すもので、全エンドポイントの実呼び出し成功を証明するものではありません。