linkedin/
search-posts

キーワードと任意の相対日付で、Googleにインデックスされた公開LinkedIn投稿を検索し、正規化された本文、投稿者、メディア、タグ、タイムスタンプ、表示中のエンゲージメントを返します。

LinkedIn Search Posts API

キーワード検索
相対日付
正規化された投稿
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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. 空でないクエリを1つ決め、必要に応じてプロバイダー向けの相対日付の文字列を選びます。
  2. query、date_posted、10件単位の件数を /v1/linkedin/search-posts に POST し、task_id を保存します。
  3. タスクが終了ステータスになるまで /v1/tasks/{task_id} をポーリングします。
  4. 成功したら 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 true

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

  • トピックの発見: 選定したトピック、製品、組織、人物、フレーズに言及している、公開インデックス済みの投稿を見つけます。
  • メッセージと形式のレビュー: サンプルを網羅的なものとはみなさずに、返された主張、ハッシュタグ、投稿者、リンク、メディア形式を確認します。
  • 投稿者とURLの振り分け: 手動でのフォローアップや投稿者単位の収集に向けて、公開されている投稿者と投稿URLを特定します。
  • 議論の詳細分析への引き継ぎ: 公開されている議論のレコードが必要な場合は、関連する結果URLを選び、LinkedIn Post Comments に渡します。

LinkedIn Search Posts API 活用のヒント

  • 検索サンプルを比較する場合は、同じクエリ、日付文字列、件数上限、取得スケジュールを使用してください。
  • 上流の並び順は検索ランキングとして扱い、中立的な人気度、新しさ、関連度のスコアとはみなさないでください。
  • 成功したのに結果が空でも、条件に合うLinkedIn投稿が存在しないことの証明とは解釈しないでください。
  • インデックスされたページは古い、途中で切れている、削除されている、制限されている場合があるため、重要な本文やメディアは元の投稿で確認してください。
  • 取得できないエンゲージメント値は0ではなく不明として扱い、各スナップショットに collected_at を保持してください。
  • 対象の投稿者がすでにわかっている場合は、company-posts または profile-posts を使用してください。

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サイト、アカウントシグナル、取得可能な指標を返します。

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

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

LinkedIn Search Posts API — よくある質問

LinkedIn Search Posts APIは、1つのキーワードクエリと任意の相対日付の文字列から、Googleにインデックスされた公開LinkedIn投稿を見つけるためのプログラムインターフェースです。正規化された投稿本文、投稿者、メディア、タグ、タイムスタンプ、表示中のエンゲージメントを返します。

はい。query は空でない文字列である必要があります。このエンドポイントには、投稿者、企業、言語、コンテンツ種別、エンゲージメント、並べ替えのネイティブフィルターはありません。

プロバイダーがドキュメント化している値は last-hour、last-day、last-week、last-month、last-year です。SocQは空でない文字列をこの列挙値で独自に制限せずに転送するため、それ以外の値の扱いはプロバイダーに依存します。

10〜2000の整数で、10の倍数である必要があります。デフォルトは10です。

いいえ。Googleのインデックス状況、公開状況、プロバイダーのカーソル制限、空のページ、カーソルの重複や欠落によって、収集が早く終了する場合があります。

返されません。このエンドポイントが出力するのは正規化された投稿レコードです。選定した投稿URLの下にある公開の議論を取得するには、LinkedIn Post Comments を使用してください。

返された投稿1件につき0.5 SocQクレジットで、基本料金はかかりません。デフォルトの見積もりは10件で、結果が空の場合は結果に対する課金はなく、許可されている場合は実際の使用量が見積もりを上回ることがあります。