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と収集条件を送信し、非同期タスクを追跡して、保存された正規化投稿をページごとに読み取ります。
- パスが /in/ で始まる公開LinkedInプロフィールURLを1つ以上用意します。
- only_authored_posts と、プロフィールごとの results_limit(1〜2000)を指定します。プロバイダー向けの日付文字列は必要な場合のみ追加します。
- リクエストを /v1/linkedin/profile-posts に POST し、成功または失敗するまで /v1/tasks/{task_id} をポーリングします。
- 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 trueLinkedIn 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を区別し、メディア、ハッシュタグ、メンションは空の場合があることを前提にしてください。
- 正規化されたサンプルだけから、専門性、在職状況、感情、リードの質、影響力、コンテンツの効果を推測しないでください。
関連API
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動画の字幕をテキストに変換します。