Snapchat公開データAPI
既知の公開Snapchat Spotlightを、取得可能なクリエイター、キャプション、メディア、音源、タイムスタンプ、再生時間、エンゲージメントのフィールドを含む正規化レコードとして取得できます。
利用できるSnapchat API
公開されている snapchat.com のSpotlight URLが1件手元にあり、取得可能な詳細を標準の結果形式で取得したい場合は、Snapchat Spotlightを使用します。
取得できるSnapchatデータ
SocQは既知の公開Spotlight 1件を固定の ReelVideoItem レコードに変換し、取得元のレスポンスで得られたフィールドのみを保持します。
Spotlightの識別情報と取得元
取得可能なアイテムID、元の公開URL、リソースの種類、公開日時、取得日時を保持します。
キャプションとクリエイターのコンテキスト
取得可能なテキストに加え、クリエイターID、ユーザー名、表示名、プロフィールURL、プロフィール画像、認証・プライバシーのフラグを返します。
動画、音源、分類
取得可能なメディア参照、再生時間、音源のメタデータ、ショートコード、ハッシュタグ、メンションを正規化レコードに保持します。
表示中のエンゲージメント
取得可能ないいね数、コメント数、シェア数、再生数、表示回数を、特定時点の公開値として取得します。
SocQ vs Snapchatのプロダクトツール
SocQは、対応する公開Spotlightの詳細照会に特化しています。一方、Snapchatのアプリやクリエイター・ビジネス向けツールは、認可された投稿、アカウント、オーディエンス、広告のワークフローを対象としています。
| 機能 | SocQ | Snapchatのプロダクトツール |
|---|---|---|
| 主な用途 | 既知の公開Spotlight 1件の詳細を取得 | 認可済みコンテンツの作成、公開、管理、分析、プロモーション |
| 認証 | SocQのAPIキー | Snapchatアカウント、アプリ、トークン、またはプロダクト固有の認可 |
| 入力の起点 | 公開 snapchat.com のURL 1件 | 認可済みアカウントまたはプロダクトのコンテキスト |
| コンテンツの公開・管理 | 非対応 | 該当するSnapchatプロダクトで利用可能 |
| レスポンス形式 | 正規化された ReelVideoItem レコード | プロダクト固有のSnapchatオブジェクトとインターフェース |
Snapchat APIの仕組み
Snapchat Spotlightでは、非同期タスクの後に保存済みの結果を取得します。
1. 公開URLを送信
snapchat.com のSpotlight URLを1件送信し、返された task_id を保存します。
2. タスクを追跡
処理が成功するか失敗が報告されるまで、/v1/tasks/{task_id} をポーリングします。
3. 保存済みの結果を読み取る
data.results.items を読み取ります。next_cursor は、共通のタスク結果リーダーがさらに保存済みのレコードがあると示した場合のみ使用します。
SocQのAPIキーで認証し、公開SpotlightのURLを1件送信します。
curl -X POST "https://api.socq.ai/v1/snapchat/spotlight" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.snapchat.com/@queenhaley_13/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYY2pnZnF0bG52AZslQsUdAZslQoRQAAAAAQ"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.itemsSnapchat APIの主なユースケース
選定コンテンツの調査
選び出したSpotlight URLを追跡可能なレコードに変換し、レビューやアノテーションに活用します。
カタログの情報補完
既存のリンク集に、取得可能なクリエイター、キャプション、メディア、音源、再生時間、分類、タイムスタンプのフィールドを追加します。
エンゲージメントのスナップショット
collected_at を観測日時として保持しながら、別々に取得した結果の間で表示中の指標を比較します。
制限事項と公開データポリシー
Snapchat Spotlightの結果は特定時点の公開レコードであり、認可が必要なSnapchatアカウントの操作は提供しません。
- ペイロードには必須の url を1つだけ指定でき、results_limit や callback_url などの追加フィールドは受け付けません。
- 検証では snapchat.com とそのサブドメインを受け付けますが、パス名は検証しません。関係のないパスは提供元で失敗する可能性があるため、公開Spotlightのリンクを使用してください。
- 提供元は詳細照会を1回行い、正規化アイテムを最大1件返します。Spotlightのフィードは返しません。
- 保存済み結果のページネーションは共通のタスク結果リーダーの機能であり、Snapchatの取得元のページネーションではありません。
- 任意のキャプション、クリエイター、メディア、公開日時、音源、再生時間、分類、指標のフィールドは null になる場合があります。
- このエンドポイントは、ログイン、投稿の公開、編集、削除、モデレーション、アカウント管理、広告運用は行いません。
Snapchat APIに関するよくある質問
Snapchat Spotlight APIでは何を取得できますか?
既知の公開Spotlightを1件取得し、取得時点で利用可能な取得元のフィールドを含む正規化レコードを最大1件返します。
Snapchat APIでSpotlightのフィードを取得できますか?
いいえ。現在のエンドポイントは単一の詳細照会で、取得元の検索用にプロフィール、検索語、カーソル、results_limit を受け付けません。
返されるエンゲージメント数はリアルタイムですか?
いいえ。取得可能な数値は collected_at 時点で取得した公開スナップショットとして扱ってください。完全な分析データや継続的に更新される分析データではありません。
SocQからSnapchatに投稿できますか?
いいえ。この公開データのエンドポイントは、ログイン、投稿の公開、アカウント管理、モデレーション、広告の操作を提供しません。
Snapchat Spotlightの料金はどのように計算されますか?
成功したタスクは、返されたフィールドの有無や結果の件数にかかわらず、1回あたり一律0.19 SocQクレジットです。
プラットフォームを横断してデータを組み合わせ、より包括的なビジネスインサイトを
さまざまなプラットフォームの公開プロフィール、コンテンツ、エンゲージメントデータを1つのワークフローに集約し、ブランド、クリエイター、トピックの追跡やクロスプラットフォームのモニタリング・分析をより効率的に行えます。
Twitch API
既知の公開Twitchユーザー名から正規化されたプロフィールや公開動画の一覧を取得したり、クリップ1件をダウンロード可能な動画とともに取得したりでき、クリエイター調査、カタログの情報補完、比較、スナップショットのモニタリングに活用できます。
Rednote API
公開プロフィールとノートの取得、ノートやユーザーの検索、コメントとネストされた返信の取得、ホームのおすすめ1ページ分の取得ができます。
Kwai API
公開Kwaiプロフィール、アカウントの投稿1ページ分、既知の投稿1件を取得できます。アカウント情報、コンテンツ、メディア、タイムスタンプ、表示中のエンゲージメントは正規化されています。
Truth Social API
公開アカウントの詳細の取得、アカウントの投稿の取得元1ページ分の取得、既知の投稿URL 1件の解決ができ、正規化レコードとして返します。
Google Ad Library API
公開広告主の検索、企業ごとのクリエイティブの取得、URLによる既知の透明性センターのクリエイティブ1件の取得ができ、調査やレビューに活用できます。
Google Maps API
公開スポットの検索、既知のMaps URLの正規化された詳細の取得、取得元に紐づくスポット情報と投稿者のコンテキストを含む公開クチコミの取得ができます。


