LinkedIn Companies
公開LinkedIn会社ページには、組織の説明、Webサイト、業種、規模、本社所在地、拠点、専門分野、表示中のフォロワー数と従業員数が掲載されています。これらの属性は、取引先データの補完、企業のセグメンテーション、市場マッピング、公開企業情報の経時的な比較に活用できます。
LinkedIn Companies API の主な機能
- 公開会社ページで指定1つ以上のLinkedIn /company/{slug} URLを処理します。個人プロフィール、投稿、求人情報が混在することはありません。
- 企業情報とWebプレゼンス公開されている会社名、説明、Webサイト、ロゴ、LinkedInページURLを1件の正規化レコードで返します。
- 構造化された企業属性業種、企業規模、本社所在地、設立年、拠点、専門分野を、フィルタリングや比較にそのまま使えるフィールドとして提供します。
- 表示中のフォロワー数と従業員数取得可能なフォロワー数と従業員数を、企業属性とは別の指標として返します。
LinkedIn Companies API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
urls | 必須 | 必須。公開LinkedIn会社ページURLのリストです。すべてのURLは、linkedin.com またはLinkedInのサブドメイン上の /company/{slug} パスである必要があります。 |
LinkedIn Companies API の使い方
把握済みの会社ページを送信し、データセットタスクの完了を待ってから、得られた企業属性レコードをページごとに取得します。
- /company/{slug} の形式に沿った公開会社リンクを用意します。
- urls リストを /v1/linkedin/companies に POST し、task_id を保存します。
- 企業データの処理が完了または失敗するまで、/v1/tasks/{task_id} でタスクを確認します。
- data.results.items を読み取り、追加の結果ページがある場合は next_cursor を使って取得します。
curl -X POST "https://api.socq.ai/v1/linkedin/companies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.linkedin.com/company/microsoft/"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueLinkedIn Companies API の主なユースケース
- 取引先・CRMデータの補完: 既知の会社ページにひも付くレコードに、会社の説明、Webサイト、ロゴ、業種、規模、本社所在地を追加します。
- 企業のセグメンテーション: 業種、企業規模、拠点、専門分野で組織を分類し、調査やアカウントプランニングに活用します。
- 市場・拠点のマッピング: 本社所在地と拠点の配列を使い、選定した企業がどこで事業を展開しているかを比較します。
- 公開企業情報のモニタリング: 保存した企業レコードを比較し、説明、拠点、専門分野、表示中の規模指標の変化を把握します。
LinkedIn Companies API 活用のヒント
- 送信前に会社のスラッグを正規化して重複を排除し、表記の異なる /company/ URLから同じレコードが重複して作成されないようにしてください。
- 複数の値を持つ企業属性を損なわないよう、industries、locations、specialties は配列のまま保持してください。
- 企業属性や表示中の数値の経時的な変化を比較する場合は、保存する各レコードに collected_at を残してください。
関連API
LinkedIn Companies API 以外に別の種類の公開LinkedInデータが必要な場合は、これらのAPIをご利用ください。
- LinkedIn Profiles API — プロフィールURLから、公開プロフィールの人物情報、役職、所在地、表示中のオーディエンス数、職歴、学歴、スキルを正規化して返します。
- LinkedIn Posts API — 対応するURLから、公開投稿のテキスト、投稿者、表示中のエンゲージメント、メディア、公開日時、種類、ハッシュタグを取得します。
- LinkedIn Jobs API — 公開求人の職種名、企業、説明、勤務地、応募資格、雇用条件、応募リンク、取得可能な給与フィールドを正規化して返します。
- LinkedIn Company Jobs API — 用意したLinkedInの/jobs/ URLから公開求人を探し、正規化された職種、企業、勤務地、雇用形態、経験、リモート、給与、掲載時期の各フィールドを返します。
- LinkedIn Company Posts API — LinkedInの企業ページURLから公開投稿を探し、テキスト、投稿者情報、メディア、ハッシュタグ、タイムスタンプ、表示中のエンゲージメントを返します。
- LinkedIn Post Comments API — 既知のLinkedIn投稿に表示される公開コメントを取得し、テキスト、投稿者情報、タイムスタンプ、関連ID、表示中のいいね数と返信数を返します。