JSON API

Каждый генератор доступен и как простой GET-эндпоинт. Ключ не нужен. Добросовестное использование: до 120 запросов в минуту с одного IP.

GET https://randhome.org/api/v1/us/phones?count=2

{
  "data": [
    { "formatted": "(415) 738-2049", "e164": "+14157382049" },
    { "formatted": "(614) 290-5531", "e164": "+16142905531" }
  ]
}

Страны

Замените us в пути на любой из этих кодов.

usСоединенные Штаты
caКанада
gbВеликобритания *
deГермания
frФранция
esИспания
nlНидерланды
brБразилия
mxМексика

/api/v1/us/identities

Параметры: count (1–100, default 10), seed, gender (any|female|male), region (as for addresses; not GB), type (any|mobile|landline; not US, CA)
Пример: /api/v1/us/identities?count=3&gender=female

/api/v1/us/names

Параметры: count (1–100, default 10), seed, gender (any|female|male), rarity (common|any), middle (true|false; US, CA, GB)
Пример: /api/v1/us/names?count=3&gender=female

/api/v1/us/first-names

Параметры: count (1–100, default 10), seed, gender, rarity
Пример: /api/v1/us/first-names?count=5

/api/v1/us/last-names

Параметры: count (1–100, default 10), seed, rarity
Пример: /api/v1/us/last-names?count=5&rarity=any

/api/v1/us/nicknames

Параметры: count (1–100, default 10), seed, style (mixed|words|name|gamer), case (camel|lower|snake), digits
Пример: /api/v1/us/nicknames?style=gamer&digits=true

/api/v1/us/phones

Параметры: count (1–100, default 10), seed, format (national|international|e164|digits; dashed|dotted for US, CA), type (any|mobile|landline; not US, CA), area_code (US, CA)
Пример: /api/v1/us/phones?count=5&format=e164

/api/v1/us/addresses

Параметры: count (1–100, default 10), seed, region (ISO 3166-2 code without the country prefix: CA, BY, IDF…)
Пример: /api/v1/us/addresses?count=5&region=CA