API一覧に戻る
独立系の公開広告データ

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の別プロダクトです。

機能SocQLinkedIn Campaign Manager
主な用途公開広告レコードの検索と正規化認可済みキャンペーンの作成と管理
入力企業名やキーワードによる検索、または正確な詳細URL 1件認可済みのアカウントとキャンペーンの識別子
認証SocQのAPIキーLinkedInアカウントと広告の権限
出力公開されている開示フィールド非公開のキャンペーン設定とレポート

LinkedIn Ad Library APIの仕組み

どちらのエンドポイントも、SocQの送信、ポーリング、読み取りという非同期ワークフローを使用します。Searchは複数ページを返す場合があり、Ad Detailsは最大1件のレコードを返します。

  1. 1. エンドポイントを選ぶ

    Searchには企業名、企業ID、キーワードを、Ad Detailsには正確な公開広告ライブラリの詳細URLを1件送信します。

  2. 2. タスクを送信して追跡

    リクエストをPOSTして task_id を保存し、処理が終わるまで /v1/tasks/{task_id} をポーリングします。

  3. 3. 正規化されたレコードを読み取る

    data.results.items を処理し、has_more が true の間は next_cursor をたどります。詳細リクエストは0件または1件のアイテムを返します。

公開LinkedIn広告を検索

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件をダウンロード可能な動画とともに取得したりでき、クリエイター調査、カタログの情報補完、比較、スナップショットのモニタリングに活用できます。