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 の使い方
保存したい投稿を正確に指定し、処理タスクを追跡して、構造化されたコンテンツ結果を読み取ります。
- 各公開リンクが /posts/、/pulse/、または対応する /feed/update/ のURNを使用していることを確認します。
- リンクを urls として /v1/linkedin/posts に送信し、task_id を取得します。
- 投稿の処理が成功するか失敗を返すまで、/v1/tasks/{task_id} を確認します。
- 最初の 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 trueLinkedIn Posts API の主なユースケース
- キャンペーンコンテンツのアーカイブ: 特定のキャンペーン投稿群について、投稿本文、投稿者、メディア、公開日時、取得元URLを保存します。
- トピックとメッセージの調査: 投稿本文、見出し、ハッシュタグを分析し、選定したLinkedInコンテンツのテーマを比較します。
- コンテンツ形式の分析: post_type とメディアのフィールドを使い、選定したコンテンツに含まれる形式を比較します。
- 公開エンゲージメントの比較: 保存した投稿群について、表示中のいいね数・コメント数・リポスト数を比較します。
LinkedIn Posts API 活用のヒント
- 下流のレコードを元の入力までたどれるようにする必要がある場合は、返された url とあわせて送信したURLも保持してください。
- 投稿リンクをまとめて処理する前に、URL文字列全体だけでなく activity または share の識別子でも重複を排除してください。
- すべての公開投稿で表示されるとは限らないため、メディア、ハッシュタグ、タイトル、見出し、投稿種別は任意項目として扱ってください。
- 同じ投稿でも後の実行で異なる数値が表示されることがあるため、表示中のエンゲージメント指標とあわせて collected_at を保持してください。
- 下流のアプリケーションで返された投稿本文をHTMLとして表示する前に、エスケープまたはサニタイズしてください。
関連API
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動画の字幕をテキストに変換します。