Random User Generator
Free random user data API for generating realistic fake user profiles with names, addresses, photos, and contact data for UI mockups and testing. Open-source REST API with no authentication required, seedable for reproducibility, and multi-format output (JSON, CSV, YAML, XML).
1 APIs
8 Features
Test DataSynthetic DataMock DataOpen SourcePublic APIFree API
Free and unauthenticated
No API key, no signup, no per-key quotas; just hit the endpoint.
Seedable reproducibility
The same (seed, page, results, version) tuple always returns the same users.
Multi-nationality cohort
Mix 21 nationalities (v1.4) so addresses, IDs, and phone formats stay locale-appropriate.
Field projection
Use `inc` / `exc` to keep payloads small and skip CPU-heavy fields like `login`.
Multi-format output
JSON, PrettyJSON, CSV, YAML, XML; plus JSONP via `callback`.
Path-pinned versioning
Lock requests to /1.0/ through /1.4/ so upstream releases never break your fixtures.
Pre-generated portrait images
Three resolutions (large, medium, thumbnail) hosted on randomuser.me.
Open source
MIT-licensed Node.js codebase; self-hostable if you need air-gapped operation.
opencollection: 1.0.0
info:
name: Random User Generator API
version: '1.4'
items:
- info:
name: Users
type: folder
items:
- info:
name: Generate Random Users
type: http
http:
method: GET
url: https://randomuser.me/api/
params:
- name: results
value: '10'
type: query
description: Number of user records to generate. Maximum 5000 per request.
- name: gender
value: female
type: query
description: Restrict to a single gender. Omit or use any other value to return both.
- name: nat
value: us,gb,fr
type: query
description: 'Comma-separated list of two-letter nationality codes. Supported (v1.4):
AU, BR, CA, CH, DE, DK, ES, FI, FR, GB, IE, IN, IR, MX, NL, NO, NZ,
RS, TR, UA, US. Omit for a mix of all nationalities.
'
- name: inc
value: name,email,nat
type: query
description: 'Comma-separated list of top-level fields to include. Allowed values:
gender, name, location, email, login, registered, dob, phone, cell,
id, picture, nat. Mutually exclusive with `exc`.
'
- name: exc
value: login
type: query
description: 'Comma-separated list of top-level fields to exclude. Allowed values
same as `inc`. Mutually exclusive with `inc`.
'
- name: seed
value: foobar
type: query
description: 'Deterministic seed. The same seed (with the same page, results, and
version) always returns the same users.
'
- name: page
value: '3'
type: query
description: 'Page number (1-based) for paginated seeded results. Use with `seed`
and a fixed `results` value to walk a stable dataset.
'
- name: format
value: csv
type: query
description: 'Response serialization format. Defaults to JSON.
'
- name: password
value: upper,lower,number,8-16
type: query
description: 'Password composition rules: `CHARSETS,MIN-MAX` or `CHARSETS,MAX`.
Charsets: special, upper, lower, number (comma-separated, in any order).
Default: ~10k top-used passwords; otherwise 8-64 characters.
'
- name: dl
value: ''
type: query
description: 'If present, returns the response as a file download with the
appropriate extension for the requested `format`.
'
- name: noinfo
value: ''
type: query
description: 'If present, omits the `info` envelope (seed, results, page, version)
from the response.
'
- name: callback
value: randomuserdata
type: query
description: 'JSONP callback function name. Only honored for JSON formats.
'
docs: 'Generate one or more random user records. Supports controlling result count,
gender, nationality mix, included/excluded fields, password composition,
format (JSON/CSV/YAML/XML/PrettyJSON), seeded reproducibility, and pagination.
'
- info:
name: Generate Random Users (Pinned Version)
type: http
http:
method: GET
url: https://randomuser.me/api/:version/
params:
- name: version
value: '1.4'
type: path
description: API version to pin (e.g. `1.4`).
- name: results
value: '10'
type: query
description: Number of user records to generate. Maximum 5000 per request.
- name: gender
value: female
type: query
description: Restrict to a single gender. Omit or use any other value to return both.
- name: nat
value: us,gb,fr
type: query
description: 'Comma-separated list of two-letter nationality codes. Supported (v1.4):
AU, BR, CA, CH, DE, DK, ES, FI, FR, GB, IE, IN, IR, MX, NL, NO, NZ,
RS, TR, UA, US. Omit for a mix of all nationalities.
'
- name: inc
value: name,email,nat
type: query
description: 'Comma-separated list of top-level fields to include. Allowed values:
gender, name, location, email, login, registered, dob, phone, cell,
id, picture, nat. Mutually exclusive with `exc`.
'
- name: exc
value: login
type: query
description: 'Comma-separated list of top-level fields to exclude. Allowed values
same as `inc`. Mutually exclusive with `inc`.
'
- name: seed
value: foobar
type: query
description: 'Deterministic seed. The same seed (with the same page, results, and
version) always returns the same users.
'
- name: page
value: '3'
type: query
description: 'Page number (1-based) for paginated seeded results. Use with `seed`
and a fixed `results` value to walk a stable dataset.
'
- name: format
value: csv
type: query
description: 'Response serialization format. Defaults to JSON.
'
- name: password
value: upper,lower,number,8-16
type: query
description: 'Password composition rules: `CHARSETS,MIN-MAX` or `CHARSETS,MAX`.
Charsets: special, upper, lower, number (comma-separated, in any order).
Default: ~10k top-used passwords; otherwise 8-64 characters.
'
- name: dl
value: ''
type: query
description: 'If present, returns the response as a file download with the
appropriate extension for the requested `format`.
'
- name: noinfo
value: ''
type: query
description: 'If present, omits the `info` envelope (seed, results, page, version)
from the response.
'
- name: callback
value: randomuserdata
type: query
description: 'JSONP callback function name. Only honored for JSON formats.
'
docs: 'Same as `generateUsers` but pinned to a specific API version so future
releases cannot break the response shape. Supported versions: 1.0, 1.1,
1.2, 1.3, 1.4.
'
bundled: true
