LinkedIn Ad Library API
構造化された検索入力で公開LinkedIn広告を見つけ、選んだ開示レコードを正確な詳細URLで取得して、調査、レビュー、アーカイブに活用できます。
利用できるLinkedIn Ad Library API
企業名、企業ID、キーワードで公開レコードを検索するにはAd Search、正確な公開URLから既知のレコードを1件取得するにはAd Detailsを使用します。
取得できるLinkedIn広告ライブラリのデータ
SocQは公開されている開示フィールドを、非公開のキャンペーン分析データとして扱うことなく正規化します。取得元で利用できない値は null または空のままです。
広告と広告主の基本情報
公開されている場合、固定の広告ID、公開詳細URL、広告主ID、名称、企業URL、ロゴを取得します。
クリエイティブとリンク先のコンテキスト
取得可能な広告テキスト、フォーマット、画像や動画のアセット、掲載面、ランディングページのリンク先を取得します。
公開されている配信の開示情報
取得元が提供する配信期間、国、プラットフォーム、インプレッション、取得日時を保持します。
SocQ vs LinkedIn Campaign Manager
SocQは、公開広告ライブラリの開示情報を取得します。Campaign Managerは、認可された広告主が自社のキャンペーンを管理するためのLinkedInの別プロダクトです。
| 機能 | SocQ | LinkedIn Campaign Manager |
|---|---|---|
| 主な用途 | 公開広告レコードの検索と正規化 | 認可済みキャンペーンの作成と管理 |
| 入力 | 企業名やキーワードによる検索、または正確な詳細URL 1件 | 認可済みのアカウントとキャンペーンの識別子 |
| 認証 | SocQのAPIキー | LinkedInアカウントと広告の権限 |
| 出力 | 公開されている開示フィールド | 非公開のキャンペーン設定とレポート |
LinkedIn Ad Library APIの仕組み
どちらのエンドポイントも、SocQの送信、ポーリング、読み取りという非同期ワークフローを使用します。Searchは複数ページを返す場合があり、Ad Detailsは最大1件のレコードを返します。
1. エンドポイントを選ぶ
Searchには企業名、企業ID、キーワードを、Ad Detailsには正確な公開広告ライブラリの詳細URLを1件送信します。
2. タスクを送信して追跡
リクエストをPOSTして task_id を保存し、処理が終わるまで /v1/tasks/{task_id} をポーリングします。
3. 正規化されたレコードを読み取る
data.results.items を処理し、has_more が true の間は next_cursor をたどります。詳細リクエストは0件または1件のアイテムを返します。
SocQのAPIキーで認証します。Searchのデフォルトは24件です。Ad Detailsは正確な詳細URLを1件受け付け、ページネーションはありません。
curl -X POST "https://api.socq.ai/v1/linkedin-ad-library/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"company":"Microsoft","countries":["US"],"results_limit":24}'
# Or retrieve one known record:
# POST /v1/linkedin-ad-library/ad
# {"url":"https://www.linkedin.com/ad-library/detail/666281156"}
# Poll GET /v1/tasks/{task_id}LinkedIn Ad Library APIの主なユースケース
競合広告の発掘
選んだ企業に関連する確認可能な公開広告を見つけ、開示のコンテキストを保持してレビューに活用します。
クリエイティブのレビュー
選んだレコードを取得し、取得可能なテキスト、メディア、フォーマット、リンク先、広告主、配信期間を確認します。
公開広告データセット
正規化された広告の基本情報、広告主、クリエイティブ、配信、取得元、取得日時のフィールドを保存し、分析に活用します。
制限事項と公開データポリシー
結果は取得時点の公開インデックスとレコードの表示状況を反映したもので、非公開のCampaign Managerのデータではありません。
- Searchには、company、keyword、company_id のうち少なくとも1つが必要です。複数を組み合わせた場合は、取得元の一致ロジックに従います。
- countries には2文字の国コードを指定し、日付は有効な範囲である必要があります。results_limit は24〜1,992の範囲で24の倍数を指定します。
- 完了した検索でもアイテムが含まれない場合や、取得元の行が重複する場合があります。利用できない詳細URLでは、レコードが返らないこともあります。
- 広告主、クリエイティブ、配信、インプレッション、リンク先、フォーマット、メディアのフィールドは欠ける場合があり、0と解釈しないでください。
LinkedIn Ad Library APIに関するよくある質問
何を送信できますか?
Searchは、企業名、企業ID、キーワード、または対応する組み合わせを受け付けます。Ad Detailsは、正確な公開LinkedIn広告ライブラリの詳細URLを1件受け付けます。
このAPIは非公開のキャンペーン分析データを返しますか?
いいえ。取得可能な公開開示情報を返すもので、Campaign Managerの費用、クリック数、コンバージョン、ターゲティングルール、アカウントのデータは提供しません。
各エンドポイントで何件のレコードを取得できますか?
Searchのデフォルトは24件で、1,992件までの24の倍数を指定できます。Ad Detailsは0件または1件のレコードを返します。
結果の料金はどのように計算されますか?
返された広告レコードは1件あたり0.5クレジットです。レコードのない成功タスクには、結果に対する料金は発生しません。
プラットフォームを横断してデータを組み合わせ、より包括的なビジネスインサイトを
さまざまなプラットフォームの公開プロフィール、コンテンツ、エンゲージメントデータを1つのワークフローに集約し、ブランド、クリエイター、トピックの追跡やクロスプラットフォームのモニタリング・分析をより効率的に行えます。
Reddit API
既知のURLから公開Redditの投稿とコメントを取得したり、サブレディットの新着・トップ・人気の投稿を閲覧したり、キーワードと公開期間で議論を検索したりできます。
Pinterest API
公開Pinterestプロフィールのデータ取得、既知のピンの解決、指定したプロフィールのピンの取得、キーワード検索ができ、クリエイター、コンテンツ、ビジュアルトレンドの調査に活用できます。
Threads API
公開Threadsプロフィールの取得、既知の投稿の解決、指定したプロフィールの投稿の取得ができます。アカウント情報、コンテンツ、メディア、エンゲージメント、タイムスタンプのフィールドは正規化されています。
Bluesky API
公開Blueskyプロフィールの取得、既知の投稿URLの解決、アカウントの投稿の1ページ分の取得ができます。アカウント情報、コンテンツ、メディア、タイムスタンプ、表示中のエンゲージメントのフィールドは正規化されています。
Snapchat API
既知の公開Snapchat Spotlightを、取得可能なクリエイター、キャプション、メディア、音源、タイムスタンプ、再生時間、エンゲージメントのフィールドを含む正規化レコードとして取得できます。
Twitch API
既知の公開Twitchユーザー名から正規化されたプロフィールや公開動画の一覧を取得したり、クリップ1件をダウンロード可能な動画とともに取得したりでき、クリエイター調査、カタログの情報補完、比較、スナップショットのモニタリングに活用できます。

