linkedin/
profile-posts

LinkedInプロフィールのURLに関連する公開投稿を収集し、正規化された本文、投稿者情報、メディア、ハッシュタグ、タイムスタンプ、表示中のエンゲージメントを返します。

LinkedIn Profile Posts API

プロフィールURLから収集
本人投稿フィルター
プロフィールごとの件数上限
結果1件あたり1クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

LinkedIn Profile Posts

LinkedInプロフィールに関連するフィードには、メンバーページからの本人による投稿、リポスト、記事、画像、動画、ドキュメント、その他の公開アクティビティが含まれることがあります。返されるレコードは、コンテンツ調査に使える取得時点のサンプルであり、完全なアクティビティ履歴、非公開の分析データ、つながり限定の公開範囲を表すものではありません。

LinkedIn Profile Posts API の主な機能

  • プロフィールURLからの収集1つ以上の公開LinkedIn /in/ URLを受け付け、送信した各プロフィールに関連する投稿を収集します。
  • 任意の本人投稿フィルターonly_authored_posts を転送し、関連アクティビティを、プロバイダーが対象プロフィール本人の投稿と判断したものに絞り込みます。
  • プロバイダー側の期間指定任意の start_date と end_date の文字列をプロバイダー側のフィルタリング用に転送し、こちら側で形式、順序、境界値の扱い、タイムゾーンのルールを強制しません。
  • 正規化されたコンテンツ情報取得可能な投稿本文、投稿者フィールド、公開日時、メディア、ハッシュタグ、メンション、取得元URLを、安定した投稿スキーマで返します。
  • 表示中のエンゲージメントのスナップショット取得可能ないいね数・コメント数・シェア数・表示回数を collected_at とともに保持し、各数値を観測時点にひも付けます。

LinkedIn Profile Posts API のパラメータ

パラメータ必須説明
urls必須必須。LinkedInのホスト上にあり、パスが /in/ で始まる公開LinkedInプロフィールURLのリストです。
start_date任意任意。各入力プロフィールに対して転送される、空でないプロバイダー向けの日付フィルター文字列です。SocQは形式や境界値の扱いを解析・検証しません。
end_date任意任意。各入力プロフィールに対して転送される、空でないプロバイダー向けの日付フィルター文字列です。SocQは start_date との前後関係を確認しません。
only_authored_posts任意任意。各プロフィールに対して転送されるブール値です。true にするとプロバイダーが本人の投稿と判断したものを要求しますが、SocQ側で本人確認を行うものではありません。
results_limit任意任意。1〜2000の整数で、各プロフィールURLに個別に適用されます。デフォルトはプロフィールごとに100です。

LinkedIn Profile Posts API の使い方

プロフィールURLと収集条件を送信し、非同期タスクを追跡して、保存された正規化投稿をページごとに読み取ります。

  1. パスが /in/ で始まる公開LinkedInプロフィールURLを1つ以上用意します。
  2. only_authored_posts と、プロフィールごとの results_limit(1〜2000)を指定します。プロバイダー向けの日付文字列は必要な場合のみ追加します。
  3. リクエストを /v1/linkedin/profile-posts に POST し、成功または失敗するまで /v1/tasks/{task_id} をポーリングします。
  4. data.results.items を読み取り、has_more が true の間は next_cursor で続きを取得します。
curl -X POST "https://api.socq.ai/v1/linkedin/profile-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.linkedin.com/in/satyanadella/"],"only_authored_posts":true,"results_limit":20}'

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

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

  • 公開コミュニケーションのレビュー: 選定したビジネスプロフィールに関連して返された投稿全体で、トピック、主張、リンク、繰り返し使われる表現を分析します。
  • 本人投稿のサンプリング: only_authored_posts を使ってより絞り込んだサンプルを要求し、投稿者が重要な場合は返された投稿者フィールドを確認します。
  • 形式とメディアの調査: 返されたレコードの範囲内で、取得可能な画像、動画、ドキュメント、記事、ハッシュタグ、メンションの傾向を比較します。
  • 期間を区切ったエンゲージメントのスナップショット: プロバイダー向けの日付文字列を指定し、published_at と collected_at を保持したまま、収集したサンプル内でのみ表示中のエンゲージメントを比較します。

LinkedIn Profile Posts API 活用のヒント

  • results_limit はプロフィールごとの上限として扱ってください。上限20で5つのURLを指定すると、最大100件の投稿が保存されます。
  • SocQは日付の形式、順序、境界、タイムゾーンを検証しないため、日付入力はプロバイダー向けの文字列のまま扱い、自社の規約を文書化しておいてください。
  • only_authored_posts が重要な場合は、返された投稿者を確認してください。このフラグはプロバイダーにフィルタリングを要求するもので、本人であることを証明するものではありません。
  • 表示される数値は実行ごとに変わる場合があるため、エンゲージメント指標とあわせて collected_at を保持してください。
  • タイムスタンプと指標では null と0を区別し、メディア、ハッシュタグ、メンションは空の場合があることを前提にしてください。
  • 正規化されたサンプルだけから、専門性、在職状況、感情、リードの質、影響力、コンテンツの効果を推測しないでください。

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

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

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

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

LinkedIn Profile Posts API — よくある質問

LinkedIn Profile Posts APIは、送信したLinkedInプロフィールURLに関連する公開投稿を収集し、正規化されたコンテンツ、投稿者情報、メディア、タイムスタンプ、表示中のエンゲージメントを返すプログラムインターフェースです。

linkedin.com またはLinkedInのサブドメイン上にあり、パスが /in/ で始まる http または https のURLを1つ以上送信してください。会社ページや投稿URLは、このエンドポイントの入力仕様の対象外です。

true の場合、この値はプロバイダーに転送され、対象プロフィール本人の投稿と判断されたものを要求します。SocQによる独立した本人確認ではないため、投稿者が重要な場合は返された投稿者フィールドを確認してください。

されません。SocQは空でない文字列を、形式の解析、順序の比較、境界値やタイムゾーンの定義を行わずにそのまま転送します。フィルタリングはプロバイダーの挙動に依存します。

いいえ。デフォルトは100で、URLごとに1〜2000を個別に指定できます。そのため、タスク全体の件数はプロフィールごとの上限にプロフィール数を掛けた数になる場合があります。

いいえ。その実行で、送信したプロフィールとフィルターに対して利用可能な公開投稿レコードが取得できなかったことを意味します。公開範囲やプロバイダーの状況によって、取得範囲は変わる場合があります。

正常に保存された投稿1件につき1 SocQクレジットで、基本料金はかかりません。見積もりにはプロフィールごとの結果上限が使われますが、最終的な請求は実際に保存された結果に基づきます。結果が空の場合、結果に対する課金はありません。