API JSON

Cada gerador também está disponível como um endpoint GET simples. Não é preciso chave. Uso justo: até 120 solicitações por minuto por IP.

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

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

Países

Troque us no caminho por qualquer um destes códigos.

usEstados Unidos
caCanadá
gbReino Unido *
deAlemanha
frFrança
esEspanha
nlPaíses Baixos
brBrasil
mxMéxico

/api/v1/us/identities

Parâmetros: count (1–100, default 10), seed, gender (any|female|male), region (as for addresses; not GB), type (any|mobile|landline; not US, CA)
Exemplo: /api/v1/us/identities?count=3&gender=female

/api/v1/us/names

Parâmetros: count (1–100, default 10), seed, gender (any|female|male), rarity (common|any), middle (true|false; US, CA, GB)
Exemplo: /api/v1/us/names?count=3&gender=female

/api/v1/us/first-names

Parâmetros: count (1–100, default 10), seed, gender, rarity
Exemplo: /api/v1/us/first-names?count=5

/api/v1/us/last-names

Parâmetros: count (1–100, default 10), seed, rarity
Exemplo: /api/v1/us/last-names?count=5&rarity=any

/api/v1/us/nicknames

Parâmetros: count (1–100, default 10), seed, style (mixed|words|name|gamer), case (camel|lower|snake), digits
Exemplo: /api/v1/us/nicknames?style=gamer&digits=true

/api/v1/us/phones

Parâmetros: 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)
Exemplo: /api/v1/us/phones?count=5&format=e164

/api/v1/us/addresses

Parâmetros: count (1–100, default 10), seed, region (ISO 3166-2 code without the country prefix: CA, BY, IDF…)
Exemplo: /api/v1/us/addresses?count=5&region=CA