LinkedIn Company Posts
LinkedIn会社ページの投稿は、組織のページに関連して表示される公開アップデートで、本文、投稿者情報、メディア、公開日時、トピック、表示中のエンゲージメントを含みます。これらのレコードは、コミュニケーションのモニタリング、コンテンツのレビュー、メディア分析、選定した組織や期間をまたいだ比較に活用できます。
LinkedIn Company Posts API の主な機能
- 会社ページを起点とした収集1つ以上の公開LinkedIn /company/ URLを使い、選定した各組織ページに関連する投稿を収集します。
- 投稿者の情報正規化された author オブジェクトを返すため、会社ページとの関連と、個々の投稿で特定される個人や投稿者とを区別して扱えます。
- コンテンツとメディアのシグナル投稿本文、添付メディア、ハッシュタグ、メンション、公開日時、元の投稿URLを各レコードにまとめます。
- 表示中のエンゲージメントのスナップショット取得可能ないいね数・コメント数・シェア数・表示回数を、推定リーチやビジネス成果ではなく、取得時点のカウンターとして提供します。
- 任意のプロバイダー日付値空でない start_date と end_date の文字列を各入力URLとともにそのまま転送し、こちら側で形式、順序、境界値の扱い、タイムゾーンの解釈を強制しません。
LinkedIn Company Posts API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
urls | 必須 | 必須。http または https の公開LinkedIn会社ページURLのリストです。各ホストは linkedin.com またはLinkedInのサブドメインで、パスは /company/ で始まる必要があります。 |
start_date | 任意 | 任意。各URLに対して転送される、空でないプロバイダー日付値です。ドキュメント上の例は YYYY-MM-DD ですが、サービス側では形式、境界値の扱い、タイムゾーンを解析しません。 |
end_date | 任意 | 任意。各URLに対して転送される、空でないプロバイダー日付値です。サービス側では形式を確認せず、start_date より後であることも求めません。 |
results_limit | 任意 | 任意。各入力URLに個別に適用される件数の上限(整数)です。デフォルトは100、最小値は1、最大値は2000です。 |
LinkedIn Company Posts API の使い方
会社ページのURLを任意の日付値とともに送信し、非同期タスクをポーリングして、カーソルで各ページを読み取ります。
- パスが /company/ で始まる公開LinkedIn URLを用意します。
- urls、任意の start_date と end_date の文字列、results_limit を /v1/linkedin/company-posts に POST し、task_id を保存します。
- タスクが succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
- data.results.items を読み取り、has_more が true の間は next_cursor で続きを取得します。
curl -X POST "https://api.socq.ai/v1/linkedin/company-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.linkedin.com/company/microsoft/"],"start_date":"2026-01-01","end_date":"2026-06-30","results_limit":20}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueLinkedIn Company Posts API の主なユースケース
- 公開コミュニケーションのタイムライン: 選定した会社ページについて、投稿本文、公開日時、取得元URL、投稿者情報を、確認しやすいタイムラインに整理します。
- トピックとメディアのレビュー: ハッシュタグ、メンション、本文、メディア参照を使い、返されたサンプル内で繰り返し登場する公開テーマやコンテンツ形式を分析します。
- 比較可能なエンゲージメントのスナップショット: 日付、件数上限、取得タイミングを揃えたうえで、返された投稿間の表示中のいいね数・コメント数・シェア数・表示回数を比較します。
- 追加分析するコンテンツの選定: 投稿ID、URL、投稿者、本文、カウンターを使い、後でコメント分析やクリエイティブ分析を行う特定のレコードを選びます。
LinkedIn Company Posts API 活用のヒント
- 複数ページのタスクを送信する前に、すべての入力が完全なLinkedIn /company/ URLであることを検証してください。
- start_date と end_date はプロバイダー定義の文字列として扱ってください。YYYY-MM-DD を一貫して使用し、こちら側での検証、境界値の扱い、順序の確認は前提にしないでください。
- 複数の会社ページを比較する場合は、日付、results_limit、取得タイミングを揃えてください。
- 会社ページに関連付けられていても、その会社ページが投稿者であるとは限らないため、すべてのレコードで author と投稿URLを確認してください。
- 重複するページや繰り返しの実行で同じ投稿が返される場合は、固定の投稿 id またはURLで重複を排除してください。
- 公開アセットは取得後にリダイレクト、期限切れ、利用不可になる場合があるため、メディアリンクはそれを前提に保存してください。
関連API
LinkedIn Company Posts API 以外に別の種類の公開LinkedInデータが必要な場合は、これらのAPIをご利用ください。
- LinkedIn Profiles API — プロフィールURLから、公開プロフィールの人物情報、役職、所在地、表示中のオーディエンス数、職歴、学歴、スキルを正規化して返します。
- LinkedIn Companies API — 公開企業の説明、Webサイト、ロゴ、表示中のオーディエンス数と従業員数、業種、所在地、専門分野を正規化して返します。
- LinkedIn Posts API — 対応するURLから、公開投稿のテキスト、投稿者、表示中のエンゲージメント、メディア、公開日時、種類、ハッシュタグを取得します。
- LinkedIn Post Comments API — 既知のLinkedIn投稿に表示される公開コメントを取得し、テキスト、投稿者情報、タイムスタンプ、関連ID、表示中のいいね数と返信数を返します。
- LinkedIn Profile Posts API — LinkedInのプロフィールURLに関連する公開投稿を探し、投稿者情報、メディア、ハッシュタグ、タイムスタンプ、表示中のエンゲージメントを返します。
- LinkedIn Video Transcript API — 動画を含む投稿のURLから、LinkedIn動画の字幕をテキストに変換します。