twitch/
profile

公開Twitchユーザー名を1件照会し、アカウント情報、プロフィール文、画像、アカウントフラグ、表示中の指標、取得時の情報を含む正規化プロフィールレコードを返します。

Twitch Profile API

ユーザー名1件で指定
正規化アカウントレコード
リクエスト単位の固定料金
1リクエストあたり0.19クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

Twitch Profile

公開Twitchプロフィールでは、ユーザー名、表示名、プロフィール文、プロフィール画像、Webサイト、認証・非公開の状態、所在地情報、表示中のアカウント数値が公開されている場合があります。正規化されたアカウントレコードは、クリエイター情報の補完、プロフィールの確認、繰り返し取得できる公開データのスナップショットに活用できますが、チャンネル管理や認証済みアカウントでの操作は提供しません。

Twitch Profile API の主な機能

  • ユーザー名による正確な照会使用可能な文字で構成される1〜64文字の必須 username を1件送信します。先頭に @ を1つ付けることもできます。
  • 正規化された公開アカウント情報取得可能なプロフィールID、公開URL、ユーザー名、表示名、プロフィール文、アバター、カバー画像、Webサイトを AccountItem 仕様で読み取れます。
  • アカウント状態のシグナル取得可能な認証フラグと非公開フラグは null 許容のフィールドとして保持し、提供元が公開していない値を推測で補いません。
  • 表示中のプロフィール指標取得可能なフォロワー数・フォロー数・投稿数を、取得時刻にひもづく個別の任意指標として利用できます。
  • 非同期タスクの流れユーザー名を送信して task_id を保持し、共通のタスク取得APIをポーリングして、成功後に保存済みの正規化結果を取得します。
  • リクエスト単位の固定料金成功したタスクの料金は固定で0.19 SocQクレジットで、任意フィールドの有無には左右されません。

Twitch Profile API のパラメータ

パラメータ必須説明
username必須必須。Twitchユーザー名です。前後の空白を除去した後、先頭に @ を1つ付けることができ、その後はASCIIの英字、数字、ドット、アンダースコア、ハイフンで構成される1〜64文字である必要があります。

Twitch Profile API の使い方

対応するTwitchユーザー名を1件送信して非同期タスクを追跡し、共通のカーソル形式のレスポンスで保存済みのプロフィール結果1件を読み取ります。

  1. 使用可能な文字のルールに合う公開Twitchユーザー名を1件選びます。
  2. username を /v1/twitch/profile に POST し、返された task_id を保存します。
  3. タスクが成功するか失敗を返すまで /v1/tasks/{task_id} をポーリングします。
  4. data.results.items を読み取ります。プロフィール照会で得られるソースレコードは最大1件ですが、保存済み結果のエンベロープには has_more と next_cursor も含まれます。
curl -X POST "https://api.socq.ai/v1/twitch/profile" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"ninja"}'

# Poll GET /v1/tasks/{task_id}
# Read the normalized account in data.results.items

Twitch Profile API の主なユースケース

  • クリエイターレコードの情報補完: 既知のクリエイターレコードに、取得可能なTwitchのアカウント情報、プロフィール文、画像、Webサイト、アカウントフラグ、公開数値を追加します。
  • ユーザー名の確認ワークフロー: 社内のエンティティや調査対象にひもづける前に、送信されたハンドルを正規化された公開プロフィールに照会します。
  • 公開アカウントの比較: 個別に送信したユーザー名同士で、同じ AccountItem 形式を使って表示中のフォロワー数・フォロー数・投稿数を比較します。
  • プロフィールの変化のモニタリング: null 許容のアカウント情報フィールドと指標を collected_at とともに保存し、後の実行結果を別々の公開スナップショットとして区別できるようにします。

Twitch Profile API 活用のヒント

  • TwitchチャンネルのURLではなくユーザー名を送信してください。このエンドポイントでは url と results_limit はリクエストフィールドとして受け付けられません。
  • 先頭の @ は任意で1つまでにしてください。空白、スラッシュ、ASCII以外の文字、@ の重複は、実行時のユーザー名ルールで失敗します。
  • ソースのプロフィールレコードは0件または1件です。タスク取得APIの limit パラメータを、プロフィールから動画やフォロワーへ展開する手段と解釈しないでください。
  • ID、URL、プロフィール文、画像、Webサイト、アカウントフラグ、所在地、各指標は null 許容として扱い、スナップショット比較のために collected_at を保存してください。
  • 動画やクリップには、利用可能な場合は別のTwitchコンテンツ用エンドポイントを使用してください。このエンドポイントは読み取り専用のプロフィール照会で、ログイン、配信・投稿、モデレーション、チャンネル管理は行いません。

Twitch Profile API 以外に別の種類の公開Twitchデータが必要な場合は、これらのAPIをご利用ください。

  • Twitch User Videos API
  • Twitch Clip Downloader API — クリップURLから公開Twitchクリップを1件取得し、タイトル、再生数、長さ、作成日時、配信者プロフィール、ダウンロードできるMP4リンクとサムネイルを返します。

他のプラットフォームを見る

Twitchのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

Twitch Profile API — よくある質問

Twitch Profile APIは、公開Twitchユーザー名から正規化されたアカウントレコードを取得するインターフェースです。取得可能なアカウント情報、プロフィール文、画像、アカウントフラグ、所在地、指標、取得日時を返します。

前後の空白を除去した後、username は任意の先頭 @ 1つと、それに続くASCIIの英字、数字、ドット、アンダースコア、ハイフンで構成される1〜64文字を受け付けます。空白、スラッシュ、追加の @、その他の文字は拒否されます。

できません。リクエスト仕様では必須の username を1件のみ受け付け、usernames、url、urls、results_limit などの呼び出し側が指定したフィールドは拒否されます。

提供元の処理では、送信したユーザー名に対して最大1件のプロフィールオブジェクトを照会します。完了した結果には、limit、has_more、next_cursor フィールドを持つ共通の保存済み結果エンベロープが引き続き使われます。

公開ソースのデータが取得できない場合、正規化仕様では ID、URL、ユーザー名、名前、プロフィール文、画像、Webサイト、認証、非公開設定、所在地、個々の指標に null が許容されます。

成功したタスク1件につき固定で0.19 SocQクレジットです。この固定料金は、単一のプロフィール結果で値が入った任意フィールドの数によって変わりません。