Aller au générateur

API JSON

Chaque générateur est aussi disponible en simple point d'accès GET. Aucune clé n'est nécessaire. Usage raisonnable : jusqu'à 120 requêtes par minute et par IP.

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

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

Pays

Remplacez us dans le chemin par l'un de ces codes.

  • usÉtats-Unis
  • caCanada
  • gbRoyaume-Uni *
  • deAllemagne
  • frFrance
  • esEspagne
  • nlPays-Bas
  • brBrésil
  • mxMexique

/api/v1/us/identities

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

/api/v1/us/names

Paramètres
count (1–100, default 10), seed, gender (any|female|male), rarity (common|any), middle (true|false; US, CA, GB)
Exemple
/api/v1/us/names?count=3&gender=female

/api/v1/us/first-names

Paramètres
count (1–100, default 10), seed, gender, rarity
Exemple
/api/v1/us/first-names?count=5

/api/v1/us/last-names

Paramètres
count (1–100, default 10), seed, rarity
Exemple
/api/v1/us/last-names?count=5&rarity=any

/api/v1/us/nicknames

Paramètres
count (1–100, default 10), seed, style (mixed|words|name|gamer), case (camel|lower|snake), digits
Exemple
/api/v1/us/nicknames?style=gamer&digits=true

/api/v1/us/phones

Paramètres
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)
Exemple
/api/v1/us/phones?count=5&format=e164

/api/v1/us/addresses

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