Change Name and Bio API Documentation

Introduction

The Change Name API allows clients to update their name on Telegram.

Endpoint

Method: POST
URL: /profile-name-change

Request Body

• change_name (Boolean, optional): Specifies whether to change the name and bio.

• gender (String or List, optional): Specifies the gender for the new name. Options include "M" (male) or "F" (female).

• locales (List, optional): Specifies the locales to use for generating fake data.

• folder (String, required): The folder containing the accounts to be checked for spambots.

• phones (List, required): The list of phones to be checked

• male_ratio (INTEGER, optional): the ratio between males and females. It specifies the ratio of and remaining automaticaly assign to other gender.

• full_name_ratio (INTEGER, optional): It specifies the ratio of above specified ratio and remaining automaticaly assign to other gender.

Example Request Body

{
    "change_name": true | false,
    "gender": "M | F",
    "locales": ["en_US"],
    "folder": "active",
    "phones": ["123456789", "123456780"],
    "male_ratio": 50, // means 50% male ( rest female)
    "full_name_ratio": 50, // means 50% will have full-name ( rest will have first-name)
}

Locales list

[
    "ar_AA",
    "ar_AE",
    "ar_BH",
    "ar_EG",
    "ar_JO",
    "ar_PS",
    "ar_SA",
    "az_AZ",
    "bg_BG",
    "bn_BD",
    "bs_BA",
    "cs_CZ",
    "da_DK",
    "de",
    "de_AT",
    "de_CH",
    "de_DE",
    "dk_DK",
    "el_CY",
    "el_GR",
    "en",
    "en_AU",
    "en_BD",
    "en_CA",
    "en_GB",
    "en_IE",
    "en_IN",
    "en_NZ",
    "en_PH",
    "en_TH",
    "en_US",
    "es",
    "es_AR",
    "es_CA",
    "es_CL",
    "es_CO",
    "es_ES",
    "es_MX",
    "et_EE",
    "fa_IR",
    "fi_FI",
    "fil_PH",
    "fr_BE",
    "fr_CA",
    "fr_CH",
    "fr_FR",
    "fr_QC",
    "ga_IE",
    "he_IL",
    "hi_IN",
    "hr_HR",
    "hu_HU",
    "hy_AM",
    "id_ID",
    "it_CH",
    "it_IT",
    "ja_JP",
    "ka_GE",
    "ko_KR",
    "la",
    "lb_LU",
    "lt_LT",
    "lv_LV",
    "mt_MT",
    "ne_NP",
    "nl_BE",
    "nl_NL",
    "no_NO",
    "or_IN",
    "pl_PL",
    "pt_BR",
    "pt_PT",
    "ro_RO",
    "ru_RU",
    "sk_SK",
    "sl_SI",
    "sq_AL",
    "sv_SE",
    "ta_IN",
    "th",
    "th_TH",
    "tl_PH",
    "tr_TR",
    "tw_GH",
    "uk_UA",
    "vi_VN",
    "zh_CN",
    "zh_TW",
    "zu_ZA",
]