linkedin/
post-comments

既知のLinkedIn投稿に表示される公開コメントを収集し、正規化された本文、投稿者情報、タイムスタンプ、関連ID、表示中の反応数を返します。

LinkedIn Post Comments API

単一の投稿URL
公開コメント本文
反応のスナップショット
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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を送信し、非同期タスクを追跡して、完了したタスクに保存されたコメントをページごとに読み取ります。

  1. パスが /posts/、/pulse/、または activity もしくは share のURNを含む /feed/update/ である公開LinkedIn URLを1つ選びます。
  2. それを url として /v1/linkedin/post-comments に送信し、返された task_id を保存します。
  3. タスクが成功するか失敗を返すまで、/v1/tasks/{task_id} をポーリングします。
  4. 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 true

LinkedIn 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の別のコメントページを取得するものではありません。

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から公開投稿を探し、テキスト、投稿者情報、メディア、ハッシュタグ、タイムスタンプ、表示中のエンゲージメントを返します。

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

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

LinkedIn Post Comments API — よくある質問

LinkedIn Post Comments APIは、既知のLinkedIn投稿1件に表示される公開コメントを収集し、正規化された本文、公開されている投稿者情報、タイムスタンプ、関連ID、取得可能ないいね数と返信数を返すプログラムインターフェースです。

/posts/ または /pulse/ のパス、もしくはURNが activity または share を示す /feed/update/ のパスを使用する、http または https の公開LinkedIn URLを1つ送信してください。

しません。投稿のレスポンスとともに表示されるコメント配列を処理します。完了したSocQタスクの next_cursor は、そのタスクにすでに保存されている結果レコードをページ送りするだけです。

このエンドポイントは、返信を展開するための個別のリクエストを行いません。コメントに replies_count があっても、返されるレコードに返信の本文が含まれない場合があります。

公開ソースが常にこれらを公開しているとは限らないため、これらのフィールドは null を許容します。いいね数や返信数が取得できない場合は null のままで、0に変更されることはありません。

いいえ。その時点で利用可能な公開コメントレコードが取得できなかったことを意味します。アクセス、公開範囲、取得元のレスポンス状況によって、取得できる内容は変わる場合があります。

正常に保存されたコメントレコード1件につき0.5 SocQクレジットで、基本料金はかかりません。実行前の見積もりは100件の結果を前提としていますが、最終的な請求は実際に保存された結果件数に基づきます。結果が空の場合、結果に対する課金はありません。