LinkedIn Search Posts
LinkedIn Search Postsは、上流のGoogleインデックスを利用した検索方法で1つのキーワードクエリに一致する公開ページを見つけ、取得可能な投稿レコードを抽出します。結果はLinkedInのパーソナライズされたネイティブ検索や完全なアーカイブではなく取得時点のランク付けされたサンプルなので、会話の総量、リーチ、感情、シェア・オブ・ボイスとして扱わないでください。
LinkedIn Search Posts API の主な機能
- キーワードを軸にした検索トピック、組織、製品、人物、フレーズを表す、空でない必須のクエリ1つで、公開インデックスされたLinkedInページを検索します。
- 任意の相対日付date_posted の文字列をプロバイダーに転送します。ドキュメント化されている値は last-hour、last-day、last-week、last-month、last-year です。
- ページ単位に揃えた件数上限results_limit は10〜2000の範囲で10の倍数を設定できます。デフォルトは10で、受け付けられた値であってもプロバイダー側での取得件数は保証されません。
- 正規化された投稿レコード本文、投稿者、指標、メディア、ハッシュタグ、メンション、公開日時、取得日時の安定したフィールドを受け取れます。
- カーソルを考慮した収集指定した上限に達する、最終ページまたは空のページになる、カーソルがない、カーソルが重複する、のいずれかで収集が止まるまで、プロバイダーのカーソルをたどります。
LinkedIn Search Posts API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
query | 必須 | 必須。公開インデックス済み投稿の検索に使用する、空でないキーワードまたはフレーズです。 |
date_posted | 任意 | 任意。プロバイダーに転送される、空でない相対日付の文字列です。SocQはプロバイダーがドキュメント化している値を独自に強制しません。 |
results_limit | 任意 | 任意。結果件数の上限(整数)です。デフォルトは10で、10〜2000を指定でき、プロバイダーのページサイズである10件の倍数である必要があります。 |
LinkedIn Search Posts API の使い方
キーワードクエリを1つ送信し、非同期タスクをポーリングして、返された検索サンプルを確認します。
- 空でないクエリを1つ決め、必要に応じてプロバイダー向けの相対日付の文字列を選びます。
- query、date_posted、10件単位の件数を /v1/linkedin/search-posts に POST し、task_id を保存します。
- タスクが終了ステータスになるまで /v1/tasks/{task_id} をポーリングします。
- 成功したら data.results.items を処理し、has_more が true の間は next_cursor をたどって続きを取得します。
curl -X POST "https://api.socq.ai/v1/linkedin/search-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"AI agents","date_posted":"last-week","results_limit":10}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueLinkedIn Search Posts API の主なユースケース
- トピックの発見: 選定したトピック、製品、組織、人物、フレーズに言及している、公開インデックス済みの投稿を見つけます。
- メッセージと形式のレビュー: サンプルを網羅的なものとはみなさずに、返された主張、ハッシュタグ、投稿者、リンク、メディア形式を確認します。
- 投稿者とURLの振り分け: 手動でのフォローアップや投稿者単位の収集に向けて、公開されている投稿者と投稿URLを特定します。
- 議論の詳細分析への引き継ぎ: 公開されている議論のレコードが必要な場合は、関連する結果URLを選び、LinkedIn Post Comments に渡します。
LinkedIn Search Posts API 活用のヒント
- 検索サンプルを比較する場合は、同じクエリ、日付文字列、件数上限、取得スケジュールを使用してください。
- 上流の並び順は検索ランキングとして扱い、中立的な人気度、新しさ、関連度のスコアとはみなさないでください。
- 成功したのに結果が空でも、条件に合うLinkedIn投稿が存在しないことの証明とは解釈しないでください。
- インデックスされたページは古い、途中で切れている、削除されている、制限されている場合があるため、重要な本文やメディアは元の投稿で確認してください。
- 取得できないエンゲージメント値は0ではなく不明として扱い、各スナップショットに collected_at を保持してください。
- 対象の投稿者がすでにわかっている場合は、company-posts または profile-posts を使用してください。
関連API
LinkedIn Search Posts API 以外に別の種類の公開LinkedInデータが必要な場合は、これらのAPIをご利用ください。
- LinkedIn Profiles API — プロフィールURLから、公開プロフィールの人物情報、役職、所在地、表示中のオーディエンス数、職歴、学歴、スキルを正規化して返します。
- LinkedIn Companies API — 公開企業の説明、Webサイト、ロゴ、表示中のオーディエンス数と従業員数、業種、所在地、専門分野を正規化して返します。
- LinkedIn Posts API — 対応するURLから、公開投稿のテキスト、投稿者、表示中のエンゲージメント、メディア、公開日時、種類、ハッシュタグを取得します。
- LinkedIn Jobs API — 公開求人の職種名、企業、説明、勤務地、応募資格、雇用条件、応募リンク、取得可能な給与フィールドを正規化して返します。
- LinkedIn Post Comments API — 既知のLinkedIn投稿に表示される公開コメントを取得し、テキスト、投稿者情報、タイムスタンプ、関連ID、表示中のいいね数と返信数を返します。
- LinkedIn Search People API — LinkedInの人物検索URLから公開プロフィールの候補を探し、正規化された人物情報、説明、画像、所在地、Webサイト、アカウントシグナル、取得可能な指標を返します。