LinkedIn Post Comments
LinkedIn投稿のコメントは特定の1件の投稿に付けられた公開の反応で、このエンドポイントはその投稿とともに表示されるコメントを個別のレコードに変換し、取得可能な本文、公開されている投稿者フィールド、公開日時と取得日時、取得元との関連、いいね数、返信数を返します。返される順序は取得元に依存し、返信数が表示されていても返信の本文が含まれるとは限りません。
LinkedIn Post Comments API の主な機能
- 既知の1件の投稿に限定対応する /posts/、/pulse/、/feed/update/ のURLを1つ受け付け、その投稿とともに表示される公開コメントを確認します。
- 正規化されたコメントレコードコメント本文に加え、取得可能なID、公開URL、公開日時、取得日時、公開されている投稿者フィールドを、安定したコメントスキーマで返します。
- 取得可能な関連情報取得元が提供する場合は parent_id と post_id を保持し、提供されない場合はこれらの定義済みフィールドを null のままにします。
- 表示中の反応カウンターlikes_count と replies_count は null を許容する値として保持し、取得できないカウンターを0に変換しません。
LinkedIn Post Comments API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
url | 必須 | 必須。/posts/、/pulse/、または /feed/update/urn:li:activity もしくは /feed/update/urn:li:share を使用する公開LinkedIn投稿URLです。 |
LinkedIn Post Comments API の使い方
対応する公開投稿URLを送信し、非同期タスクを追跡して、完了したタスクに保存されたコメントをページごとに読み取ります。
- パスが /posts/、/pulse/、または activity もしくは share のURNを含む /feed/update/ である公開LinkedIn URLを1つ選びます。
- それを url として /v1/linkedin/post-comments に送信し、返された task_id を保存します。
- タスクが成功するか失敗を返すまで、/v1/tasks/{task_id} をポーリングします。
- data.results.items を読み取り、has_more が true の間は next_cursor をたどります。このカーソルはSocQに保存された結果をページ送りするもので、LinkedIn側のコメントフィードではありません。
curl -X POST "https://api.socq.ai/v1/linkedin/post-comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.linkedin.com/posts/aagupta_what-you-need-to-know-ai-agents-activity-7354600338621906944-RvXR"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueLinkedIn Post Comments API の主なユースケース
- 既知の投稿への反応の確認: アカウントを幅広く探索することなく、選定したお知らせ、記事、キャンペーン投稿に付いた公開コメントの本文を読み取ります。
- 質問とフィードバックの振り分け: 取得元リンクと投稿者情報を保持したまま、返された本文を質問、反論、製品フィードバックとして人によるレビューに回します。
- 公開エンゲージメントのスナップショット: 返されたコメント間で取得可能ないいね数と返信数を比較し、その観測を collected_at にひも付けます。
- 取得元にひも付いたコメントアーカイブ: 正規化されたコメントレコードを、送信した投稿URLおよび取得可能な post_id や parent_id とともに保存し、後の監査や検索に備えます。
LinkedIn Post Comments API 活用のヒント
- 同じ投稿の異なるURL表記を繰り返し送信する前に、activity または share の識別子で重複を排除してください。
- results_limit、並べ替え、返信展開のフィールドは送信しないでください。受け付けるリクエストプロパティは url のみです。
- 返される順序は時系列や関連度順ではなく、取得元に依存するものとして扱ってください。
- 取得できないカウンターはエンゲージメントがないことの証拠ではないため、likes_count と replies_count では null と0を区別してください。
- 正規化されたフィールドだけから、感情、意図、役職レベル、リードの質、自動化された行動を推測しないでください。
- next_cursor は完了したタスクにすでに保存されているすべてのコメントを読み取るためだけに使用してください。LinkedInの別のコメントページを取得するものではありません。
関連API
LinkedIn Post Comments API 以外に別の種類の公開LinkedInデータが必要な場合は、これらのAPIをご利用ください。
- LinkedIn Profiles API — プロフィールURLから、公開プロフィールの人物情報、役職、所在地、表示中のオーディエンス数、職歴、学歴、スキルを正規化して返します。
- LinkedIn Companies API — 公開企業の説明、Webサイト、ロゴ、表示中のオーディエンス数と従業員数、業種、所在地、専門分野を正規化して返します。
- LinkedIn Posts API — 対応するURLから、公開投稿のテキスト、投稿者、表示中のエンゲージメント、メディア、公開日時、種類、ハッシュタグを取得します。
- LinkedIn Jobs API — 公開求人の職種名、企業、説明、勤務地、応募資格、雇用条件、応募リンク、取得可能な給与フィールドを正規化して返します。
- LinkedIn Company Jobs API — 用意したLinkedInの/jobs/ URLから公開求人を探し、正規化された職種、企業、勤務地、雇用形態、経験、リモート、給与、掲載時期の各フィールドを返します。
- LinkedIn Company Posts API — LinkedInの企業ページURLから公開投稿を探し、テキスト、投稿者情報、メディア、ハッシュタグ、タイムスタンプ、表示中のエンゲージメントを返します。