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件送信し、非同期タスクを追跡して、取得できた場合は正規化されたレコードを読み取ります。
- パスに /ad-library/detail/ を含む、http または https のLinkedIn広告ライブラリURLを1件コピーします。
- url を /v1/linkedin-ad-library/ad に POST し、返された task_id を保存します。
- タスクが成功または失敗するまで /v1/tasks/{task_id} をポーリングします。
- 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 itemLinkedIn Ad Library Ad API の主なユースケース
- 発見したLinkedIn広告の情報補完: 既知の公開詳細ページURLについて、取得可能なクリエイティブ、広告主、配信、リンク先、インプレッション、メディアのフィールドを取得します。
- 開示情報のスナップショット保存: 期間限定または制限付きの公開エントリが変更・削除される前に、正規化されたレコードと collected_at の値を保存します。
- 公開クリエイティブの比較: 選択した広告間で、メッセージ、形式、アセット、開示されている配信状況を、キャンペーンのパフォーマンスデータとみなさずに比較します。
LinkedIn Ad Library Ad API 活用のヒント
- 広告IDのみ、会社ページ、検索URL、URLのリストではなく、詳細ページの完全なURLを送信してください。
- 使用可能なアイテムのない succeeded タスクとプロバイダーの失敗は区別してください。どちらも、その広告が存在しなかったことを証明するものではありません。
- 制限付きや期限切れのレコードでは、広告主、プレビュー、支払者、テキスト、メディア、配信の情報が意図的に省略されることがあるため、null を許容するフィールドはそのまま保持してください。
- 広告を探す場合はLinkedIn Ad Library Searchを使用してください。この操作は送信した詳細ページのURLのみを取得します。
関連API
LinkedIn Ad Library Ad API 以外に別の種類の公開LinkedIn Ad Libraryデータが必要な場合は、これらのAPIをご利用ください。
- LinkedIn Ad Library Search API — 企業名、企業ID、キーワードで公開LinkedIn広告を検索します。国、日付、取得件数上限を指定できます。