プラットフォームの稼働状況
- 24時間の稼働状況
- 正常
過去30日間
利用可能な機能
Snapchatの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
プロフィールprofile | ハンドルまたはプロフィールリンクから、Snapchatのクリエイターアカウントやビジネスアカウントを検索します。自己紹介、アカウント種別、カテゴリ、登録者数、Lens・ハイライト・Spotlightの件数を取得できます。has_storyは現在ストーリーを閲覧できるかどうかを示します。非公開のSnap、連絡先、法的な身元情報は対象外です。 | 1,000リクエストあたり$1.39 | 正常 |
ストーリーズstories | Snapchatアカウントが現在公開しているストーリーを、ストーリーID、タイトル、メディアリンク、サムネイル、投稿日時とともに取得します。友達限定のストーリーにはアクセスできず、ストーリーの公開期間全体を網羅できるとは限りません。 | 1,000リクエストあたり$1.39 | 正常 |
ユーザーの投稿user_posts | SnapchatアカウントのSpotlight動画を、キャプション、メディアリンク、長さ、縦横サイズ、再生・シェア・コメント・ブースト・おすすめの各件数とともに収集します。長さの単位はミリ秒です。チャットや過去の全投稿は含まれません。 | 1,000リクエストあたり$1.39 | 正常 |
動画の詳細video | 正確な動画リンクから、SnapchatのSpotlight動画を1件取得します。キャプション本文、ハッシュタグ、再生数、シェア数、長さ、クリエイターの名前とプロフィールを取得できます。プロフィールリンクやadd/リンクは指定できません。メディアリンクは継続的なアクセスや再利用の権利を保証するものではありません。 | 1,000リクエストあたり$1.39 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
Snapchatの各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
profileプロフィール ハンドルまたはプロフィールリンクから、Snapchatのクリエイターアカウントやビジネスアカウントを検索します。自己紹介、アカウント種別、カテゴリ、登録者数、Lens・ハイライト・Spotlightの件数を取得できます。 | username | — | Sync配信 | — | 1,000リクエストあたり$1.39 | business_profile_id · username · display_name · bio · profile_type · category · subcategory · subscriber_count · is_verified · website · address · has_story · lens_count · highlight_count · spotlight_count · url · avatar_url · snapcode_url · hero_image_url · created_at · platform · related_accounts |
storiesストーリーズ Snapchatアカウントが現在公開しているストーリーを、ストーリーID、タイトル、メディアリンク、サムネイル、投稿日時とともに取得します。友達限定のストーリーにはアクセスできず、ストーリーの公開期間全体を網羅できるとは限りません。 | username | — | Sync配信 | — | 1,000リクエストあたり$1.39 | id · story_id · story_title · media_url · thumbnail_url · posted_at · username · author_name · author_url · platform |
user_postsユーザーの投稿 SnapchatアカウントのSpotlight動画を、キャプション、メディアリンク、長さ、縦横サイズ、再生・シェア・コメント・ブースト・おすすめの各件数とともに収集します。長さの単位はミリ秒です。チャットや過去の全投稿は含まれません。 | username | — | Sync配信 | — | 1,000リクエストあたり$1.39 | id · url · title · text · summary · caption · media_url · thumbnail_url · duration_ms · width · height · view_count · share_count · comment_count · boost_count · recommend_count · posted_at · username · author_name · author_url · platform |
video動画の詳細 正確な動画リンクから、SnapchatのSpotlight動画を1件取得します。キャプション本文、ハッシュタグ、再生数、シェア数、長さ、クリエイターの名前とプロフィールを取得できます。プロフィールリンクやadd/リンクは指定できません。メディアリンクは継続的なアクセスや再利用の権利を保証するものではありません。 | url | spotlight_url | Sync配信 | — | 1,000リクエストあたり$1.39 | id · url · text · hashtags · view_count · share_count · duration_ms · posted_at · thumbnail_url · media_url · username · author_name · author_url · author_avatar_url · platform |
Snapchatのprofileのパラメータはそれぞれどういう意味ですか？
ハンドルまたはプロフィールリンクから、Snapchatのクリエイターアカウントやビジネスアカウントを検索します。自己紹介、アカウント種別、カテゴリ、登録者数、Lens・ハイライト・Spotlightの件数を取得できます。has_storyは現在ストーリーを閲覧できるかどうかを示します。非公開のSnap、連絡先、法的な身元情報は対象外です。
username必須- 公開クリエイターのハンドルを指定します。ユーザー名のみ（
@プレフィックスは任意）またはsnapchat.comのプロフィールURL全体を指定できます。profileでは公開プロフィールデータ、storiesでは現在公開中のストーリー、user_postsではSpotlightのショート動画を取得します。プライベートチャットや友達限定のストーリーにはアクセスできません。Snapchat：公開プロフィール、ビジネスプロフィール、Snap Starの区別 — 公式ドキュメントでは公開プロフィールと個人アカウントを区別しており、公開プロフィールを持っていてもビジネスプロフィールやSnap Starの資格が得られるわけではないとしています。この説明はアカウントの種類と資格の範囲を定義するものであり、Webインターフェースの機能全体をこのエンドポイントに拡張するものではありません。 · 確認日
Snapchatのstoriesのパラメータはそれぞれどういう意味ですか？
Snapchatアカウントが現在公開しているストーリーを、ストーリーID、タイトル、メディアリンク、サムネイル、投稿日時とともに取得します。友達限定のストーリーにはアクセスできず、ストーリーの公開期間全体を網羅できるとは限りません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況username必須- 公開クリエイターのハンドルを指定します。ユーザー名のみ（
@プレフィックスは任意）またはsnapchat.comのプロフィールURL全体を指定できます。profileでは公開プロフィールデータ、storiesでは現在公開中のストーリー、user_postsではSpotlightのショート動画を取得します。プライベートチャットや友達限定のストーリーにはアクセスできません。Snapchat：公開ストーリーと友達限定ストーリーの範囲 — 公式ドキュメントでは、公開中の公開ストーリーは公開プロフィールページから閲覧でき、My Story · Friendsは友達のみに制限されると説明しています。EveryInfraが対象とするのは現在の公開ストーリーの範囲のみであり、友達限定のストーリーや期限切れの過去のアセットの取得は保証しません。 · 確認日
Snapchatのuser_postsのパラメータはそれぞれどういう意味ですか？
SnapchatアカウントのSpotlight動画を、キャプション、メディアリンク、長さ、縦横サイズ、再生・シェア・コメント・ブースト・おすすめの各件数とともに収集します。長さの単位はミリ秒です。チャットや過去の全投稿は含まれません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況username必須- 公開クリエイターのハンドルを指定します。ユーザー名のみ（
@プレフィックスは任意）またはsnapchat.comのプロフィールURL全体を指定できます。profileでは公開プロフィールデータ、storiesでは現在公開中のストーリー、user_postsではSpotlightのショート動画を取得します。プライベートチャットや友達限定のストーリーにはアクセスできません。Snapchat：独立した公開コンテンツハブとしてのSpotlight — 公式ドキュメントでは、Spotlightをコミュニティが投稿したSnapを見つけるための中心的なハブと定義しており、Webでも閲覧できます。この定義が対象とするのはコンテンツの種類のみです。このエンドポイントでSpotlightの検索、アップロード、トレンドの完全な絞り込みが利用できるようになるわけではありません。 · 確認日
Snapchatのvideoのパラメータはそれぞれどういう意味ですか？
正確な動画リンクから、SnapchatのSpotlight動画を1件取得します。キャプション本文、ハッシュタグ、再生数、シェア数、長さ、クリエイターの名前とプロフィールを取得できます。プロフィールリンクやadd/リンクは指定できません。メディアリンクは継続的なアクセスや再利用の権利を保証するものではありません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況url必須videoアクションに必須の、Spotlight動画の正確なURLを指定します。動画専用のエンドポイントでは、プロフィールリンクやadd/リンクを代わりに使用することはできません。プロフィール系のアクションでは、完全なURLはクリエイターのユーザー名を解析するための代替入力としてのみ使われます。Snapchat Spotlight：総再生回数とユニーク視聴者数の区別 — 公式ドキュメントでは、再生開始の総数（Views）と、ユニーク視聴者数（Viewers）、シェア数、コメント数を区別しています。EveryInfraのview_countパラメータをユニーク視聴者数として再定義しないでください。ダッシュボードの視聴時間、視聴者属性、許可されたシェアの追加指標は、このエンドポイントの保証範囲外です。 · 確認日spotlight_url任意videoアクションで互換性のために使用する補助的な入力で、urlより優先度が低くなります。通常の公開動画のリクエストでは、urlを直接指定してください。
Snapchat APIの使い方
- 01公開カタログからプラットフォームのアクションを選択します。
- 02プラットフォーム、アクション、必須パラメータをPOST /api/v1/socialに送信します。
- 03レスポンスから結果を読み取ります。非同期のアクションの場合は、返されたジョブIDをポーリングします。
- 04アプリケーションで必要なレスポンスフィールドを保存します。
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"snapchat","action":"profile","params":{"username":"<username>"}}'
Snapchat APIに関する質問
Snapchat APIでは何を取得できますか？
platformをsnapchatに設定します。現在のカタログにはプロフィール、ストーリーズ、ユーザーの投稿、動画の詳細が掲載されています。これらのアクション名はそれぞれ異なるSnapchatのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
Snapchatのprofileリクエストを開始するには、どの入力を使用しますか？
公開クリエイターのハンドルを指定します。ユーザー名のみ（@プレフィックスは任意）またはsnapchat.comのプロフィールURL全体を指定できます。profileでは公開プロフィールデータ、storiesでは現在公開中のストーリー、user_postsではSpotlightのショート動画を取得します。プライベートチャットや友達限定のストーリーにはアクセスできません。params内のusernameとして送信してください。
Snapchatのprofileはどのフィールドを返しますか？
宣言されたスキーマにはbusiness_profile_id、username、display_name、bioが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
Snapchatのアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。