GET一回でプロフィール、企業、投稿、求人をJSONで返します。
すべては GET /v1/linkedin にあります。type で対象を選び、URL かキーワードを渡すと、type と同じ名前のキーに結果が返ります。
この分野のツールの多くは、LinkedIn プロフィール API、企業 API、求人 API を別々の製品として別々の料金で売っています。CrustAPI では 1 つの LinkedIn データ API に課金ルールも 1 つだけ。成功した呼び出しは 1 クレジット、空またはアクセスできない結果は無料です。
| type | 返ってくるもの | 入力 |
|---|---|---|
| profile | 公開プロフィール全体。氏名、見出し、職歴、学歴、フォロワー数など。デフォルトの type です。 | url(linkedin.com/in/... の URL) |
| refresh | 現在の企業と学校を、その LinkedIn の数値 ID と companyState 付きで返します。データベースを最新に保つために作った、軽量で低遅延の呼び出しです。 | url |
| company | 公開の企業ページ。従業員リストが欲しいときは employees=true を付けます。 | url(linkedin.com/company/... の URL) |
| posts | 公開の投稿。1 回の呼び出しで最大 100 件。各投稿のコメントが欲しいときは comments=true を付けます。 | url(プロフィールまたは企業) |
| jobs | 公開の求人。1 回の呼び出しで最大 50 件、start でページ送りできます。 | keywords(任意で location も)、または求人の url |
| search(ベータ) | 人物検索。enrich=true を付けると、各人物の完全なプロフィールを同じ呼び出しで取得できます。 | keywords |
入力のルールに注意してください。profile、company、posts は url を取り、検索クエリは受け付けません。名前しかない場合は、まず type=search(ベータ)で人物を見つけ、返ってきたプロフィール URL を渡します。
これは上の curl が実際に返した JSON そのもので、幅に合わせて省略しています。800 ミリ秒で返り、1 クレジットかかりました。
注目したいフィールドが 2 つあります。accessible は、そのプロフィールに公開ページが存在するかどうかを示します。false のときは profile が null になり、note が理由を説明し、その呼び出しは課金されません。
memberIdentifier は LinkedIn の変わらない数値のメンバー ID です。氏名やバニティ URL が変わっても残るため、データベースの結合キーに最適です。
公開レコード全体を構造化して返します。どの呼び出しでも同じ形なので、パーサーは一度書けば済みます。
メールのフィールドはオプトインです。プロフィール呼び出しに email=true を付けると、レスポンスに workEmail と emailStatus が追加されます。ステータスは verified、pattern-likely、unknown のいずれかなので、確認できたアドレスだけに絞り込めます。
メールはプロフィール呼び出しの 1 フィールドとして付いてくるもので、別製品ではありません。
ログインしないと見られないフィールドは、意図的に含めていません。つながりリスト、共通のつながり、プロフィールを閲覧した人は、ログアウト状態のページに現れないため、レスポンスに入りません。この線引きがあるからこそ、この API はアカウントなしで、あなたのものを何もリスクにさらさずに動きます。
分かりやすいオプションがいくつかあるだけ。ほかはすべて妥当なデフォルトになっています。
| パラメータ | 対象 | 動作 |
|---|---|---|
| url | profile, refresh, company, posts, jobs | linkedin.com の URL。profile、company、posts では必須。jobs はキーワードの代わりに求人 URL を受け付けます。 |
| keywords | search(ベータ), jobs | 検索する内容。search では必須。jobs でも、求人 URL を渡さない限り必須です。 |
| location | jobs | 求人検索の都市や地域の絞り込み。 |
| limit | jobs, posts, search(ベータ) | 取得する件数。jobs: デフォルト 25、最大 50。posts: デフォルト 50、最大 100。search: デフォルト 10、最大 15。 |
| start | jobs | ページ送りのための結果オフセット。 |
| profile | プロフィールに workEmail と emailStatus(verified、pattern-likely、unknown)を追加します。 | |
| domain | profile | email=true と併用します。雇用主のドメイン(stripe.com など)を渡すと、プロフィールから調べる代わりにそのドメインを直接使います。より高速で、プロフィールが氏名のみに制限されている場合でも動作します。 |
| enrich | search(ベータ) | 各人物の完全なプロフィールを同じ呼び出しで返します。呼び出しごとに 1 クレジットではなく、返した完全なプロフィールごとに 1 クレジット課金されます。 |
| employees | company | 企業ページに従業員リストを含めます。 |
| comments | posts | 各投稿のコメントを含めます。 |
| member | refresh | memberIdentifier も返します。読み取りが遅いためオプトインです。ID は変わらないので、一度取得したら保存しておけば十分です。 |
| headline | profile | companyState が restricted のプロフィールで、そのメンバー自身の公開見出しの復元を試みます。ベストエフォートで、およそ 20 件に 1 件ほどです。 |
データベースを最新に保つのに、1 行ごとに HTTP のやり取りを 1 回ずつする必要はありません。1 回の POST で最大 100 件のプロフィール URL を送り、入力した順序で結果を受け取れます。
ルールは大規模な実行のために作られています。結果は送った順序と同じ順で返り、失敗した行がバッチ全体を失敗させることはなく、不正な URL は課金ではなく行ごとのエラーになります。課金は単一エンドポイントと同じで、成功した行ごとに 1 クレジット、アクセスできない行は無料です。
type は refresh(デフォルト。現在の企業と学校を数値 ID 付きで返す)か profile(レコード全体)を指定できます。member: true を付けると refresh の行に memberIdentifier が追加されます。
ゼロから最初のプロフィール JSON まで、約1分です。
無料アカウントを作成。 毎月 3,000 クレジットがもらえ、カードは不要です。
ダッシュボードからキーをコピー。 サインイン後の最初の画面にあります。
上の curl を任意のプロフィール URL で実行。 公開プロフィールが JSON として返ります。
成功した呼び出しは、type を問わず 1 クレジットです。非公開またはアクセスできないプロフィールは note 付きで null を返し、課金されません。空の検索結果も無料です。
| パック | クレジット | 支払額 |
|---|---|---|
| 無料枠 | 毎月3,000 | 0ドル、カード不要 |
| 25,000呼び出し | 25,000 | 49ドル(1,000あたり1.96ドル) |
| 100,000呼び出し | 100,000 | 149ドル(1,000あたり1.49ドル) |
| 500,000呼び出し | 500,000 | 549ドル(1,000あたり1.10ドル) |
| 2,500,000呼び出し | 2,500,000 | 1,999ドル(1,000あたり0.80ドル) |
パックは2億5,000万クレジットで100,000ドル、1,000あたり0.40ドルまで続きます。価格は税抜きです。
クレジットは前払いで、有効期限はありません。ルールの唯一の例外は、enrich=true を付けた人物検索(ベータ)で、返した完全なプロフィールごとに 1 クレジット課金されます。
関連: ログインなしで LinkedIn をスクレイピング · LinkedIn プロフィールスクレイパー · Bright Data の LinkedIn 代替 · Proxycurl 代替
1 つのエンドポイント GET /v1/linkedin で、公開の LinkedIn データをきれいな JSON で返します。type に profile、refresh、company、posts、jobs、search(ベータ)を設定します。プロフィール、企業、投稿は linkedin.com の URL を取り、jobs と人物検索はキーワードを取ります。成功した呼び出しはすべて 1 クレジットです。
いいえ。各ページの公開された、ログアウト状態の版だけを読み取ります。貼り付けるクッキーも、渡すセッションも、関わるあなたのアカウントもありません。つながりリストのようにログインしないと見られないフィールドは、意図的に製品に含めていません。
どの type でも、成功した呼び出しごとに 1 クレジットです。例外は enrich=true を付けた人物検索(ベータ)で、返した完全なプロフィールごとに 1 クレジット課金されます。非公開またはアクセスできないプロフィールは note 付きで null を返し、課金されません。空の結果は無料です。無料プランはカード不要で毎月 3,000 クレジットです。
氏名、見出し、所在地、about、フォロワー数、企業リンクと期間付きの職歴全体、学歴、写真、そして LinkedIn の変わらない数値のメンバー ID である memberIdentifier を含む安定した識別子です。email=true を付けると、verified、pattern-likely、unknown のいずれかの emailStatus 付きで workEmail が追加されます。
type=refresh を使います。現在の企業と学校を数値 ID 付きで低遅延で返します。そしてプロフィールを POST /v1/linkedin/batch で送ります。1 リクエストあたり最大 100 件の URL を、入力した順序で結果を受け取れます。失敗した行がバッチ全体を失敗させることはなく、アクセスできない行は無料です。
ログアウト状態で公開データのみを収集する方法は、コンピュータ不正利用や契約に基づく請求を繰り返し退けてきました。収集は当社が担い、あなたが得るのは誰でも見られる公開データです。当社は偽のアカウントやログインを使いません。
毎月 3,000 クレジットの無料プランから始められます。カードは不要。GET 1 回で公開プロフィールをきれいな JSON で返し、アクセスできないプロフィールは一切課金されません。あなたのアカウントがリクエストに含まれることは決してありません。
無料で 3,000 クレジットを取得