: Generate random user(s)

API: randomuser.me:randomuser.me
Endpoint: /
Response format: text/plain
Auth: unknown
Method: GET
Last Status: 200
Latency: 477ms

Description

Generate one or more random users with customizable fields, nationalities, and formats.

Parameters (12)

callback (string, query, optional)

JSONP callback function name

dl (boolean, query, optional)

Force download response

exc (string, query, optional)

Fields to exclude (comma-separated)

format (string, query, optional, default: json)

Output format

Constraints: {'enum': ['json', 'pretty', 'csv', 'yaml', 'xml']}

gender (string, query, optional)

Filter by gender

Constraints: {'enum': ['male', 'female']}

inc (string, query, optional)

Fields to include (comma-separated). If specified, only these fields are returned.

nat (string, query, optional)

Nationality or comma-separated list of nationalities

Constraints: {'enum': ['AU', 'BR', 'CA', 'CH', 'DE', 'DK', 'ES', 'FI', 'FR', 'GB', 'IE', 'IN', 'IR', 'MX', 'NL', 'NO', 'NZ', 'RS', 'TR', 'UA', 'US']}

noinfo (boolean, query, optional)

Exclude info object from response

page (integer, query, optional, default: 1)

Pagination index (1-based) for use with seed

Constraints: {'minimum': 1}

password (string, query, optional)

Custom password rules. Format: CHARSETS,MIN-MAX or CHARSETS,MAX. CHARSETS: special, upper, lower, number

results (integer, query, optional, default: 1)

Number of users to generate (1-5000)

Constraints: {'minimum': 1, 'maximum': 5000}

seed (string, query, optional)

Seed for reproducible randomization. Same seed returns same results.

Examples (2)

Generate random user(s) openapi-spec
curl 'https://randomuser.me/api/?password=special%2Cupper%2C8-64&seed=abc123&nat=gb%2Cus&inc=name%2Cgender%2Cnat&exc=login%2Cregistered'
import requests

resp = requests.get(
    "https://randomuser.me/api/",
    params={
        'password': 'special,upper,8-64',
        'seed': 'abc123',
        'nat': 'gb,us',
        'inc': 'name,gender,nat',
        'exc': 'login,registered',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("randomuser.me")
result = api.fetch("", password="special,upper,8-64", seed="abc123", nat="gb,us", inc="name,gender,nat", exc="login,registered")

for item in result:
    print(item)
const resp = await fetch("https://randomuser.me/api/?password=special%2Cupper%2C8-64&seed=abc123&nat=gb%2Cus&inc=name%2Cgender%2Cnat&exc=login%2Cregistered");
const data = await resp.json();
Generate random user(s) probe-gate
curl 'https://randomuser.me/api/?results=1&password=special%2Cupper%2C8-64&seed=abc123&format=json&nat=gb%2Cus&page=1&inc=name%2Cgender%2Cnat&exc=login%2Cregistered'
import requests

resp = requests.get(
    "https://randomuser.me/api/",
    params={
        'results': '1',
        'password': 'special,upper,8-64',
        'seed': 'abc123',
        'format': 'json',
        'nat': 'gb,us',
        'page': '1',
        'inc': 'name,gender,nat',
        'exc': 'login,registered',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("randomuser.me")
result = api.fetch("", results=1, password="special,upper,8-64", seed="abc123", format="json", nat="gb,us", page=1, inc="name,gender,nat", exc="login,registered")

for item in result:
    print(item)
const resp = await fetch("https://randomuser.me/api/?results=1&password=special%2Cupper%2C8-64&seed=abc123&format=json&nat=gb%2Cus&page=1&inc=name%2Cgender%2Cnat&exc=login%2Cregistered");
const data = await resp.json();

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 17:43:30.489958 200 477ms
2026-04-16 02:38:22.186996 200 244ms
2026-04-16 02:29:49.502799 200 227ms
2026-04-15 01:29:07.818076 200 242ms
2026-04-15 00:54:00.215166 200 234ms
2026-04-14 03:34:29.343417 200 270ms
2026-04-14 00:07:24.797473 200 236ms
2026-04-12 14:22:44.819912 200 1121ms
2026-04-12 13:27:17.432446 200 213ms
2026-04-10 01:44:34.474525 200 170ms
2026-04-10 01:39:29.586728 200 230ms
2026-04-09 02:34:34.119776 200 312ms
2026-04-09 02:15:05.553539 200 219ms
2026-03-28T05:56:07.014741 200 176ms