creator/
age-gender

Instagram、TikTok、YouTube、X、Threadsのプロフィール写真に写った顔から、クリエイターの年齢層と性別を推定し、性別推定の信頼度スコアを返します。

Age and Gender Detection API

プロフィールURL1件
年齢層
信頼度つきの性別
5つのSNS
1リクエストあたり1クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Age and Gender Detection

クリエイターのプロフィール写真ははっきりした顔写真であることが多く、そこからアカウントの持ち主のおおよその年齢層と性別を読み取れます。この推定は写真を年齢の範囲と信頼度つきの性別に変換するため、コンテンツを確認する前の段階で、クリエイターリストを属性ごとに並べ替えられます。

Age and Gender Detection API の主な機能

  • 推定年齢の範囲age_min と age_max で、24〜30歳のように推定年齢の下限と上限が年単位でわかります。
  • 信頼度つきの性別gender は male か female を返し、gender_confidence がその推定の確かさを0から100で示します。
  • 5つのSNSに対応url にはInstagram、TikTok、YouTube、X、Threadsのプロフィールを渡せ、結果の network と username でアカウントを識別できます。
  • 1回の検索で必ず1行各リクエストは x:levelsio のようにネットワークとハンドルを組み合わせた id を持つ1行を返すため、推定結果をそのままクリエイターリストに突き合わせられます。

Age and Gender Detection API のパラメータ

パラメータ必須説明
url必須プロフィール写真を分析するInstagram、TikTok、YouTube、X、ThreadsのプロフィールURLを1件。

Age and Gender Detection API の使い方

クリエイターのプロフィールURLを1件送り、年齢と性別の推定結果を読み取ります。

  1. /v1/creator/age-gender に {"url": "https://x.com/levelsio"} をPOSTします。
  2. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
  3. results.items の1行を読み取り、性別の値を使う前に gender_confidence を確認します。
curl -X POST "https://api.socq.ai/v1/creator/age-gender" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://x.com/levelsio"}'

Age and Gender Detection API の主なユースケース

  • キャンペーンのペルソナに合うクリエイター選定: 候補リストを年齢層と性別で絞り込み、キャンペーンのターゲット像に合うクリエイターだけをコンテンツ確認に進めます。
  • クリエイターDBのセグメント化: 各レコードに age_min、age_max、gender を加え、データベースを年齢帯ごとに分けてレポートや施策計画に使います。
  • 起用メンバーのバランス調整: 公開前に起用予定のクリエイターの年齢と性別の構成を確認し、特定の層に偏っていれば入れ替えます。

Age and Gender Detection API 活用のヒント

  • はっきりした顔写真を使っている個人アカウントで使いましょう。顔が1つはっきり写っていると、年齢と性別の推定が最も安定します。
  • 自動フィルターで性別を使う前に gender_confidence の下限を決め、それより低いものは目視確認に回してください。
  • 推定は範囲として扱い、age_min と age_max が目標の年齢帯に重なるかどうかでクリエイターを比べましょう。

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

  • Influencer Email Finder API — Instagram、TikTok、YouTube、X、Facebookのプロフィール1件から、クリエイターが公開しているビジネスメールを、見つかったページとともに探します。
  • Social Media Profile Finder API — プロフィールURL1件から、クリエイターがほかのSNSで運営しているアカウントを、0〜1の信頼度とマッチの根拠とともに探します。

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

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

Age and Gender Detection API — よくある質問

Age and Gender Detection APIは、プロフィール写真の顔からクリエイターの年齢層と性別を推定するためのプログラム用インターフェースです。Instagram、TikTok、YouTube、X、Threadsのプロフィールに対応し、性別の推定には信頼度スコアが付きます。

プロフィール写真の顔を分析して年単位の年齢範囲と性別を出し、gender_confidence が0から100で性別推定の確かさを示します。

プロフィール写真に顔が1つはっきり写っている個人アカウントです。推定はその顔から行われ、各行には network と username も入るので元のリストと照合できます。

1回のリクエストでInstagram、TikTok、YouTube、X、ThreadsのプロフィールURLを1件送ります。

1回の検索は1クレジットで1行が返ります。プロフィールが存在しない場合はタスクが失敗し、全額返金されます。