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
Отправьте ссылку на профиль автора и прочитайте оценку возраста и пола.
- Отправьте POST-запрос на /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, используйте эти API, когда нужен другой тип публичных данных Creator.
- Influencer Email Finder API — Находите публичные деловые email автора по одному профилю в Instagram, TikTok, YouTube, X или Facebook вместе со страницами, где они указаны.
- Social Media Profile Finder API — Находите по одной ссылке на профиль аккаунты автора в других сетях, каждый с уверенностью от 0 до 1 и доказательствами совпадения.