linkedin/
company-posts

LinkedIn会社ページのURLから公開投稿を収集し、投稿本文、投稿者情報、メディア、ハッシュタグ、タイムスタンプ、表示中のエンゲージメントを正規化レコードとして返します。

LinkedIn Company Posts API

会社ページから収集
任意の日付指定
公開投稿レコード
結果1件あたり1クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

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を任意の日付値とともに送信し、非同期タスクをポーリングして、カーソルで各ページを読み取ります。

  1. パスが /company/ で始まる公開LinkedIn URLを用意します。
  2. urls、任意の start_date と end_date の文字列、results_limit を /v1/linkedin/company-posts に POST し、task_id を保存します。
  3. タスクが succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
  4. 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 true

LinkedIn 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で重複を排除してください。
  • 公開アセットは取得後にリダイレクト、期限切れ、利用不可になる場合があるため、メディアリンクはそれを前提に保存してください。

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動画の字幕をテキストに変換します。

他のプラットフォームを見る

LinkedInのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

LinkedIn Company Posts API — よくある質問

LinkedIn Company Posts APIは、LinkedInの /company/ ページURLから公開投稿を収集するためのプログラムインターフェースです。正規化された本文、投稿者情報、メディア、ハッシュタグ、メンション、公開日時、表示中のエンゲージメントを返します。

各値は、linkedin.com またはLinkedInのサブドメイン上の、http または https の完全なURLで、パスが /company/ で始まる必要があります。個人の /in/ プロフィールや個別の投稿URLは、このエンドポイントのURL検証を通過しません。

空でない start_date と end_date の文字列は、各URLについて収集プロバイダーにそのまま転送されます。サービス側では形式の解析、順序の確認、境界値やタイムゾーンの扱いの定義を行わないため、YYYY-MM-DD の値を一貫して使用し、結果は慎重に解釈してください。

いいえ。結果は送信した会社ページの収集フィードに関連付けられますが、正規化された author は個人、企業、その他の投稿者を示す場合があります。投稿者を判断する前に author と url を確認してください。

results_limit は各会社URLに個別に適用され、1〜2000の整数を指定できます。そのため、上限20で3つのURLを指定すると、公開状況とプロバイダーの挙動によりますが、最大60件の投稿を保存できます。

そのタスクで、そのURLと日付の入力に対して対応する公開投稿が返されなかったことを意味します。その組織が一度も投稿していないことの証明ではなく、無効な入力やタスクの失敗とは区別して扱う必要があります。

返された投稿1件につき1 SocQクレジットで、基本料金はかかりません。結果が空の場合は結果に対する課金はなく、許可されている場合は実際の使用量が見積もりを上回ることがあります。