JSON-API

Jeder Generator ist auch als einfacher GET-Endpunkt verfügbar. Kein Schlüssel nötig. Fair Use: bis zu 120 Anfragen pro Minute und IP.

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

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

Länder

Ersetze us im Pfad durch einen dieser Codes.

usVereinigte Staaten
caKanada
gbVereinigtes Königreich *
deDeutschland
frFrankreich
esSpanien
nlNiederlande
brBrasilien
mxMexiko

/api/v1/us/identities

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

/api/v1/us/names

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

/api/v1/us/first-names

Parameter: count (1–100, default 10), seed, gender, rarity
Beispiel: /api/v1/us/first-names?count=5

/api/v1/us/last-names

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

/api/v1/us/nicknames

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

/api/v1/us/phones

Parameter: 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)
Beispiel: /api/v1/us/phones?count=5&format=e164

/api/v1/us/addresses

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