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件送り、年齢と性別の推定結果を読み取ります。
- /v1/creator/age-gender に {"url": "https://x.com/levelsio"} をPOSTします。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- 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 が目標の年齢帯に重なるかどうかでクリエイターを比べましょう。
関連API
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の信頼度とマッチの根拠とともに探します。