linkedin-ad-library/
ad

詳細ページのURLを指定してLinkedIn広告ライブラリの公開レコードを1件取得し、開示されている場合は正規化された広告主、クリエイティブ、配信、リンク先、インプレッション、メディアのフィールドを返します。

LinkedIn Ad Library Ad API

詳細ページのURLを指定
公開されている広告の開示情報
null を許容する透明性フィールド
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

LinkedIn Ad Library Ad

LinkedIn広告ライブラリの詳細ページは、LinkedInで配信された広告について期間を限定して公開される開示情報で、取得可能な場合はクリエイティブ、広告主、配信、リンク先、インプレッション、メディアの情報を含みます。取得したレコードはその時点で確認できた内容を記録したものであり、保持期間、制限、ソースの状況が変わると一部しか取得できなくなったり、取得できなくなったりすることがあります。

LinkedIn Ad Library Ad API の主な機能

  • 詳細ページの直接取得パスに /ad-library/detail/ を含む linkedin.com のURLを1件指定すると、正規化された公開広告レコードを最大1件取得します。
  • クリエイティブと広告主の情報取得可能な広告ID、テキスト、広告主の参照、形式、リンク先、メディアを、安定したSocQの広告形式で保持します。
  • 公開されている配信情報の開示取得可能な最初と最新の配信日、国、掲載面、安全に正規化したスカラー値のインプレッションを返します。非公開のターゲティングを再構成することはありません。
  • 制限付きレコードへの安全な対応取得できない広告主、テキスト、リンク先、インプレッション、メディアの値は、ソースが非公開にしている情報を推測せずに null を許容したままにします。

LinkedIn Ad Library Ad API のパラメータ

パラメータ必須説明
url必須必須。公開LinkedIn広告ライブラリの詳細ページURLです。スキームは http または https、ホストは linkedin.com で終わり、パスに /ad-library/detail/ を含む必要があります。

LinkedIn Ad Library Ad API の使い方

公開LinkedIn広告ライブラリの詳細ページのURLを1件送信し、非同期タスクを追跡して、取得できた場合は正規化されたレコードを読み取ります。

  1. パスに /ad-library/detail/ を含む、http または https のLinkedIn広告ライブラリURLを1件コピーします。
  2. url を /v1/linkedin-ad-library/ad に POST し、返された task_id を保存します。
  3. タスクが成功または失敗するまで /v1/tasks/{task_id} をポーリングします。
  4. data.results.items を読み取ります。詳細取得で返されるレコードは最大1件で、取得できないURLが検索に切り替わることはありません。
curl -X POST "https://api.socq.ai/v1/linkedin-ad-library/ad" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.linkedin.com/ad-library/detail/666281156"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items; this detail operation returns at most one item

LinkedIn Ad Library Ad API の主なユースケース

  • 発見したLinkedIn広告の情報補完: 既知の公開詳細ページURLについて、取得可能なクリエイティブ、広告主、配信、リンク先、インプレッション、メディアのフィールドを取得します。
  • 開示情報のスナップショット保存: 期間限定または制限付きの公開エントリが変更・削除される前に、正規化されたレコードと collected_at の値を保存します。
  • 公開クリエイティブの比較: 選択した広告間で、メッセージ、形式、アセット、開示されている配信状況を、キャンペーンのパフォーマンスデータとみなさずに比較します。

LinkedIn Ad Library Ad API 活用のヒント

  • 広告IDのみ、会社ページ、検索URL、URLのリストではなく、詳細ページの完全なURLを送信してください。
  • 使用可能なアイテムのない succeeded タスクとプロバイダーの失敗は区別してください。どちらも、その広告が存在しなかったことを証明するものではありません。
  • 制限付きや期限切れのレコードでは、広告主、プレビュー、支払者、テキスト、メディア、配信の情報が意図的に省略されることがあるため、null を許容するフィールドはそのまま保持してください。
  • 広告を探す場合はLinkedIn Ad Library Searchを使用してください。この操作は送信した詳細ページのURLのみを取得します。

LinkedIn Ad Library Ad API 以外に別の種類の公開LinkedIn Ad Libraryデータが必要な場合は、これらのAPIをご利用ください。

  • LinkedIn Ad Library Search API — 企業名、企業ID、キーワードで公開LinkedIn広告を検索します。国、日付、取得件数上限を指定できます。

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

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

LinkedIn Ad Library Ad API — よくある質問

LinkedIn Ad Library Ad APIは、詳細ページのURLからLinkedIn広告ライブラリの公開レコードを1件取得するプログラムインターフェースです。公開レコードで公開されている場合、正規化された広告主、クリエイティブ、配信、リンク先、インプレッション、メディアのフィールドを返します。

linkedin.com 上で、パスに /ad-library/detail/ を含む http または https のURLを1件送信してください。IDのみ、会社ページ、検索URL、URLのリストは受け付けません。

一部の地域ではソースがより詳しい開示情報を公開している場合がありますが、安定した仕様では、支払者の情報、ターゲティングのルール、国別のインプレッション内訳、CTA、制限ステータスの提供は保証していません。

広告が削除された、公開保持期間を過ぎて期限切れになった、制限されている、ソース側でデータが不正な形式になっている、または現在のプロバイダーでは取得できない場合があります。この操作が別の広告で代用することはありません。

返されたレコード1件につき0.5 SocQクレジットです。成功して結果が空の場合は、設定されている0クレジットの基本料金のみがかかります。