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

API оценки возраста — прогнозирование возраста по имени

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

Parameters

stringrequired

First name to estimate age for.

string

ISO 3166-1 alpha-2 country code to narrow the estimate to a specific country.

Code examples

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

When to use this API

Демографическая сегментация для маркетинга

Оцените возрастное распределение вашей пользовательской базы по именам в вашей регистрационной базе данных. Сегментируйте пользователей по возрастным группам (18–25, 26–35, 36–50, 50+) и адаптируйте кампании по электронной почте, рекомендации продуктов и рекламные объявления для каждого сегмента.

Предварительное заполнение форм и оптимизация UX

Используйте предполагаемый возраст, чтобы предварительно выбрать соответствующие параметры в формах регистрации. Для приложения финансовых услуг, если прогнозируемый возраст составляет 60+, по умолчанию используется контент планирования выхода на пенсию. Для прогнозируемого возраста 20–30 лет выделите ресурсы, связанные с студенческими кредитами или покупками первого жилья.

Обогащение данных для записей CRM

Расширьте контакты CRM, у которых есть имя, но нет возраста или даты рождения. Добавьте поле предполагаемого возраста, которое отделы продаж смогут использовать для более персонализированного охвата. Отметьте прогнозы с низкой достоверностью (небольшое количество значений) для проверки вручную.

Frequently asked questions

Насколько точен прогноз возраста?
Точность зависит от названия и страны. Распространенные имена с большим количеством выборок (более 100 тыс.) обычно прогнозируют в пределах 5–8 лет от фактического среднего значения. Редкие имена или имена, популярные среди нескольких поколений, имеют более широкую вариативность. Поле счетчика указывает на достоверность; более высокие значения означают более надежные прогнозы.
Что представляет собой поле счетчика?
Количество — это количество выборок данных, используемых для расчета прогнозируемого возраста. Число 233 482 означает, что прогноз основан на более чем 233 тысячах записей с таким именем. Более высокие значения обычно дают более надежные оценки.
Изменяет ли параметр Country_id результат?
Да. Популярность имени и возрастное распределение варьируются в зависимости от страны. «Майкл» ассоциируется с более старшей аудиторией в США, но может быть более молодым в других странах. Указание Country_id дает более точную оценку.
Могу ли я оценить возраст для любого языка или письменности?
Модель лучше всего работает с именами, написанными латиницей, распространенными в западных странах. Имена, написанные нелатинским шрифтом (китайским, арабским, кириллицей), могут иметь меньшее количество выборок и менее надежные прогнозы.
В имени учитывается регистр?
Нет. Перед обработкой имена преобразуются в нижний регистр. «Майкл», «Майкл» и «МАЙКЛ» возвращают один и тот же результат.

Get your API key

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