creator/
age-gender

Оценивает возрастной диапазон и пол автора по лицу на фото профиля в Instagram, TikTok, YouTube, X или Threads и возвращает оценку уверенности для определения пола.

Age and Gender Detection API

Одна ссылка на профиль
Возрастной диапазон
Пол с уверенностью
Пять соцсетей
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.
  • Пять сетей на входе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

Отправьте ссылку на профиль автора и прочитайте оценку возраста и пола.

  1. Отправьте POST-запрос на /v1/creator/age-gender, передав в поле url ссылку на профиль, например https://x.com/levelsio.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Прочитайте единственную строку из 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 с целевой возрастной группой.

Помимо Age and Gender Detection API, используйте эти API, когда нужен другой тип публичных данных Creator.

  • Influencer Email Finder API — Находите публичные деловые email автора по одному профилю в Instagram, TikTok, YouTube, X или Facebook вместе со страницами, где они указаны.
  • Social Media Profile Finder API — Находите по одной ссылке на профиль аккаунты автора в других сетях, каждый с уверенностью от 0 до 1 и доказательствами совпадения.

Другие платформы

Объединяйте данные Creator с публичными данными других поддерживаемых соцсетей.

Age and Gender Detection API — FAQ

Age and Gender Detection API — это программный интерфейс, который оценивает возрастной диапазон и пол автора по лицу на фото профиля. Он работает с профилями в Instagram, TikTok, YouTube, X и Threads и добавляет к определению пола оценку уверенности.

Анализируется лицо на фото профиля, в результате получаются возрастной диапазон в годах и пол, а gender_confidence по шкале от 0 до 100 показывает, насколько уверенно определен пол.

Личные аккаунты, на фото профиля которых четко видно одно лицо. Оценка строится по этому лицу, а каждая строка также содержит network и username, чтобы сопоставить ее с исходным списком.

В каждом запросе передается одна ссылка на профиль в Instagram, TikTok, YouTube, X или Threads.

Каждая проверка стоит 1 кредит и возвращает одну строку. Если профиль не существует, задача завершается ошибкой и полностью возвращается на баланс.