Перейти к содержимому
POST AI agent ready /v1/gender/estimate

API определения пола — прогнозирование пола по имени

Прогнозирует пол, связанный с именем, с помощью статистических моделей, обученных на общедоступных демографических данных. Возвращает «мужской» или «женский» с оценкой вероятности (0–1) и количеством выборок. При желании можно сузить результаты по стране для обеспечения точности в зависимости от региона.

Parameters

stringrequired

First name to predict gender for.

string

ISO 3166-1 alpha-2 country code for country-specific prediction.

Code examples

curl -X POST https://api.botoi.com/v1/gender/estimate \
  -H "Content-Type: application/json" \
  -d '{"name":"Maria","country_id":"US"}'

When to use this API

Персонализированные приветствия по электронной почте

Если в вашей CRM есть имя, но нет поля пола, используйте эту конечную точку, чтобы предсказать пол и сгенерировать соответствующие приветствия («Уважаемый мистер Смит» или «Уважаемая госпожа Джонсон»). Применяйте прогнозы только с вероятностью выше 0,90, чтобы избежать ошибок.

Демографическое обогащение опросов и аналитики

Дополните ответы на опросы или пользовательскую аналитику прогнозируемым полом, если информация не собиралась напрямую. Используйте данные для составления сводных отчетов о гендерном распределении по вашей пользовательской базе, моделях использования продукта или результатах A/B-тестирования.

Рекомендации по продуктам электронной коммерции

Предскажите пол по имени владельца учетной записи, чтобы персонализировать категории продуктов по умолчанию. Показывайте рекомендации по одежде, аксессуарам или подаркам, соответствующие предполагаемому полу, предоставляя пользователям возможность легко обновить свои предпочтения.

Frequently asked questions

Какие значения возвращает гендерное поле?
Поле пола возвращает «мужской» или «женский» на основе статистического большинства для этого имени. Для имен с почти равной вероятностью (например, «Алекс») ответ отражает незначительное большинство, и вероятность будет близка к 0,50.
Что означает показатель вероятности?
Вероятность — это значение от 0 до 1, указывающее на достоверность. Оценка 0,98 означает, что 98% людей с таким именем в наборе данных идентифицируют себя с предсказанным полом. Оценка ниже 0,60 указывает на то, что имя явно унисекс.
Влияет ли Country_id на результаты?
Да. Некоторые имена имеют разные гендерные ассоциации в разных странах. «Андреа» в англоязычных странах преимущественно женщина, а в Италии — мужчина. Предоставление Country_id дает более точные региональные прогнозы.
Как мне следует обрабатывать прогнозы с низкой вероятностью?
Для прогнозов с вероятностью ниже 0,70 считайте имя неоднозначным с гендерной точки зрения. Используйте гендерно-нейтральный язык в общении и рассмотрите возможность напрямую спросить пользователя, а не предполагать.
Могу ли я предсказать пол по прозвищам или сокращенным именам?
Да, если псевдоним достаточно распространен и может появиться в наборе данных. «Майк» вернется мужчиной, «Лиз» вернется женщиной. Необычные сокращения могут иметь меньшее количество образцов и менее надежные прогнозы.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.

Sign up free View full docs