linkedin/
posts

/posts/、/pulse/、または対応する /feed/update/ 形式のURLから公開LinkedIn投稿を取得し、正規化された本文、投稿者、メディア、公開情報、表示中のエンゲージメントを返します。

LinkedIn Posts API

投稿URLで指定
コンテンツ情報
エンゲージメントのスナップショット
結果1件あたり1クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

LinkedIn Posts

公開LinkedIn投稿は、投稿者のメッセージに、メディア、公開情報、ハッシュタグ、コンテンツ種別、表示中のいいね数・コメント数・リポスト数を組み合わせたものです。これらのシグナルは、コンテンツのアーカイブ、テーマや形式の調査、選定した投稿間での公開エンゲージメントの比較に活用できます。

LinkedIn Posts API の主な機能

  • 対応するLinkedIn投稿URL公開されている /posts/ と /pulse/ のリンクに加え、activity または share の識別子を含む /feed/update/ URLを処理します。
  • 投稿本文と投稿者情報公開されている投稿本文、取得元URL、正規化された投稿者情報を1件のコンテンツレコードにまとめて保持します。
  • メディアと公開情報取得可能なメディア参照、公開日時、タイトル、見出し、投稿種別、ハッシュタグを、投稿本文に混在させずに返します。
  • 表示中のエンゲージメント指標取得可能ないいね数・コメント数・リポスト数を、各投稿レコードの個別の指標として返します。

LinkedIn Posts API のパラメータ

パラメータ必須説明
urls必須必須。/posts/、/pulse/、または対応する /feed/update/urn:li:activity もしくは /feed/update/urn:li:share パスを使用する、公開LinkedIn投稿URLのリストです。

LinkedIn Posts API の使い方

保存したい投稿を正確に指定し、処理タスクを追跡して、構造化されたコンテンツ結果を読み取ります。

  1. 各公開リンクが /posts/、/pulse/、または対応する /feed/update/ のURNを使用していることを確認します。
  2. リンクを urls として /v1/linkedin/posts に送信し、task_id を取得します。
  3. 投稿の処理が成功するか失敗を返すまで、/v1/tasks/{task_id} を確認します。
  4. 最初の data.results.items を読み取り、has_more が true の間は next_cursor で次のページに進みます。
curl -X POST "https://api.socq.ai/v1/linkedin/posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.linkedin.com/posts/microsoft_were-more-than-a-single-story-at-microsoft-activity-7401349457478569985-pp34"]}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

LinkedIn Posts API の主なユースケース

  • キャンペーンコンテンツのアーカイブ: 特定のキャンペーン投稿群について、投稿本文、投稿者、メディア、公開日時、取得元URLを保存します。
  • トピックとメッセージの調査: 投稿本文、見出し、ハッシュタグを分析し、選定したLinkedInコンテンツのテーマを比較します。
  • コンテンツ形式の分析: post_type とメディアのフィールドを使い、選定したコンテンツに含まれる形式を比較します。
  • 公開エンゲージメントの比較: 保存した投稿群について、表示中のいいね数・コメント数・リポスト数を比較します。

LinkedIn Posts API 活用のヒント

  • 下流のレコードを元の入力までたどれるようにする必要がある場合は、返された url とあわせて送信したURLも保持してください。
  • 投稿リンクをまとめて処理する前に、URL文字列全体だけでなく activity または share の識別子でも重複を排除してください。
  • すべての公開投稿で表示されるとは限らないため、メディア、ハッシュタグ、タイトル、見出し、投稿種別は任意項目として扱ってください。
  • 同じ投稿でも後の実行で異なる数値が表示されることがあるため、表示中のエンゲージメント指標とあわせて collected_at を保持してください。
  • 下流のアプリケーションで返された投稿本文をHTMLとして表示する前に、エスケープまたはサニタイズしてください。

LinkedIn Posts API 以外に別の種類の公開LinkedInデータが必要な場合は、これらのAPIをご利用ください。

  • LinkedIn Profiles API — プロフィールURLから、公開プロフィールの人物情報、役職、所在地、表示中のオーディエンス数、職歴、学歴、スキルを正規化して返します。
  • LinkedIn Companies API — 公開企業の説明、Webサイト、ロゴ、表示中のオーディエンス数と従業員数、業種、所在地、専門分野を正規化して返します。
  • LinkedIn Company Posts API — LinkedInの企業ページURLから公開投稿を探し、テキスト、投稿者情報、メディア、ハッシュタグ、タイムスタンプ、表示中のエンゲージメントを返します。
  • LinkedIn Post Comments API — 既知のLinkedIn投稿に表示される公開コメントを取得し、テキスト、投稿者情報、タイムスタンプ、関連ID、表示中のいいね数と返信数を返します。
  • LinkedIn Profile Posts API — LinkedInのプロフィールURLに関連する公開投稿を探し、投稿者情報、メディア、ハッシュタグ、タイムスタンプ、表示中のエンゲージメントを返します。
  • LinkedIn Video Transcript API — 動画を含む投稿のURLから、LinkedIn動画の字幕をテキストに変換します。

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

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

LinkedIn Posts API — よくある質問

LinkedIn Posts APIは、対応する /posts/、/pulse/、/feed/update/ のURLから公開投稿データを取得します。正規化された本文、投稿者情報、メディア、公開情報、ハッシュタグ、表示中のいいね数・コメント数・リポスト数、取得日時を返します。

公開されている /posts/ と /pulse/ のリンクを受け付けます。/feed/update/ URLも、そのURNが activity または share を示している場合は有効です。

返されません。処理対象は urls に含まれる対応済みの公開リンクに限られ、投稿者の他の投稿を探すことはありません。

返しません。投稿レコードには表示中の comments_count が含まれる場合がありますが、個々のコメントの本文や投稿者は返されません。

投稿にメディア、ハッシュタグ、タイトル、見出し、投稿種別、表示中のエンゲージメント値が含まれていない場合があり、その場合これらの任意フィールドは null または空になります。

完了した結果に含まれる投稿レコード1件につき1 SocQクレジットです。結果が空の場合、結果に対する課金はありません。