Age and Gender Detection
创作者的主页头像往往是一张清晰的正脸照,从中可以快速判断账号背后这个人的年龄段和性别。这项查询把头像转换成估算的年龄区间和带置信度的性别,让你在花时间审看内容之前,就能先按人群属性筛选达人名单。
Age and Gender Detection API 主要特性
- 估算年龄区间age_min 和 age_max 给出估算年龄的下限和上限,单位为岁,例如 24 到 30。
- 性别及置信度gender 返回 male 或 female,gender_confidence 以 0 到 100 表示该判断的把握程度。
- 支持五个平台url 支持 Instagram、TikTok、YouTube、X 或 Threads 主页,结果中的 network 和 username 标识对应账号。
- 每次查询固定一行每次请求返回一行,id 由平台和账号名组成,例如 x:levelsio,每条估计结果都能直接对回你的创作者名单。
Age and Gender Detection API 参数
| 参数 | 必填 | 描述 |
|---|---|---|
url | 必填 | 一个 Instagram、TikTok、YouTube、X 或 Threads 主页链接,将分析该主页的头像。 |
如何使用 Age and Gender Detection API
提交一个创作者主页链接,读取年龄和性别估算结果。
- 向 /v1/creator/age-gender 发送 {"url": "https://x.com/levelsio"}。
- 轮询 GET /v1/tasks/{task_id},直到 status 为 succeeded。
- 从 results.items 读取这一行,使用性别字段前先查看 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 最佳使用场景
- 按活动人设筛选达人: 用年龄区间和性别过滤候选名单,只让符合活动目标人设的创作者进入内容审看环节。
- 细分达人数据库: 为每条达人记录补上 age_min、age_max 和 gender,再按年龄段分组,用于报表和投放规划。
- 平衡达人阵容: 在活动上线前检查拟合作达人的年龄和性别构成,某一群体占比过高时及时调整。
Age and Gender Detection API 使用建议
- 用在头像为清晰正脸照的个人账号上,画面里有一张清楚的人脸时,年龄和性别估计最可靠。
- 在自动筛选中使用性别前,先设定 gender_confidence 的最低值,低于该值的结果留给人工复核。
- 把估算结果当作区间看待,按 age_min 和 age_max 是否落在目标年龄段内来比较创作者。
相关 API
除了 Age and Gender Detection API,需要其他类型的 Creator 公开数据时,可以使用以下 API。
- Influencer Email Finder API — 根据一个 Instagram、TikTok、YouTube、X 或 Facebook 主页查找创作者公开的商务邮箱,每个邮箱都附有发现它的页面。
- Social Media Profile Finder API — 根据一个主页链接找出创作者在其他平台的账号,每个账号附 0 到 1 的置信度和匹配依据。