Random User Generator API

Free random user generator API with no key: names, addresses, emails, photos and logins in multiple nationalities. Seeded and reproducible. Tested example.

No API key requiredCORS enabledHTTPSFree tier

Endpoint tested and returned HTTP 200 on 2026-08-19

What is the Random User Generator API?

The Random User Generator is a free API that produces realistic fake user profiles — names, addresses, emails, phone numbers, photos and login credentials — across multiple nationalities, with no API key required.

This is the standard tool for seeding a UI with believable placeholder people. Each generated user is internally consistent — the name, nationality, address and photo all match — which makes mockups look far more credible than obviously fake data.

The `seed` parameter is what makes it genuinely useful in a team: the same seed always produces the same users, so your test fixtures, screenshots and visual regression baselines stay stable across runs rather than regenerating every time.

Quick facts

Base URL: https://randomuser.me/api
Authentication: No key required.
Rate limit: No published limit.
Pricing: Free, including commercial use.
CORS: Enabled — callable directly from browser JavaScript
Official docs: Read the docs

How to use the Random User Generator API

Every request below was executed against the live API on 2026-08-19, and the response shown is the real body it returned — not an illustration.

1. Generate a random user profile

GET https://randomuser.me/api/

curl

curl 'https://randomuser.me/api/'

JavaScript (fetch)

const res = await fetch("https://randomuser.me/api/");
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();
console.log(data);

Python (requests)

import requests

res = requests.get("https://randomuser.me/api/", timeout=20)
res.raise_for_status()
print(res.json())

Response — HTTP 200 (truncated)

{
  "results": [
    {
      "gender": "female",
      "name": {
        "title": "Miss",
        "first": "Eden",
        "last": "Durand"
      },
      "location": {
        "street": {
          "number": 2974,
          "name": "Rue Duquesne"
        },
        "city": "Bordeaux",
        "state": "Landes",
        "country": "France",
        "postcode": 89900,
        "coordinates": {
          "latitude": "-19.7874",
          "longitude": "88.2478"
        },
        "timezone": {
          "offset": "-5:00",
          "description": "Eastern Time (US & Canada), Bogota, Lima"
        }
      },
      "email": "eden.durand@example.com",
      "login": {
        "uuid": "44234e28-e350-44e5-b016-72ac4c880bcf",
        "username": "happykoala258",
        "password": "andrew1",
        "salt": "mubq4tEa",
        "md5": "88d488511bf8ce97c751e2970372d1ad",
        "sha1": "77798f8cd122b72790b9527a910e4a13c1595642",
        "sha256": "200a714e9095bb61eb473752688574749cc71ffda1a0813d5796cd082a3d8f4a"
      },
      "dob": {
        "date": "1981-08-12T00:35:29.512Z",
        "age": 45
      },
      "registered": {
        "date": "2018-08-03T16:20:25.280Z",
        "age": 8
      },
      "phone": "04-55-06-79-24",
      "cell": "06-64-40-24-69",
      "id": {
        "name": "INSEE",
        "value": "2810741482612 40"
      },
      "picture": {
        "large": "https://randomuser.me/api/portraits/women/29.jpg",
        "medium": "https://randomuser.me/api/portraits/med/women/29.jpg",
        "thumbnail": "https://randomuser.me/api/portraits/thumb/women/29.jpg"

Parameters

Parameter	Type	Required	Description
`results`	integer	Optional	Number of users to generate. `10`
`nat`	string	Optional	Comma-separated nationality codes. `gb,us,fr`
`gender`	string	Optional	male or female. `female`
`seed`	string	Optional	Seed for reproducible results. `bytetools`
`inc / exc`	string	Optional	Include or exclude specific fields. `name,email,picture`

Response fields

results[].nameobject: title, first and last name.
results[].emailstring: Generated email address.
results[].locationobject: Street, city, state, country, postcode and coordinates.
results[].pictureobject: Portrait URLs in large, medium and thumbnail sizes.
results[].loginobject: Username, password, uuid, salt and hashes — useful for auth testing.
info.seedstring: The seed used, so you can reproduce this exact result set.

What you can build with the Random User Generator API

Seed a database or design mockup with believable user records
Build stable test fixtures using the seed parameter
Populate user lists, avatars and profile cards in prototypes
Demonstrate table sorting, filtering and pagination with realistic data

Common errors and how to fix them

Different users on every request

No seed was supplied.

Fix: Pass `seed` with a fixed value to make results reproducible across runs.

Unwanted nationalities

Defaults draw from all supported nationalities.

Fix: Restrict with `nat`, e.g. nat=gb,us.

Oversized payload

Full user objects are large.

Fix: Use `inc` to request only the fields you actually render.

Random User Generator API — frequently asked questions

Is the Random User Generator free?

Yes, completely free with no API key, and it permits commercial use.

How do I get the same fake users every time?

Pass a `seed` parameter with any fixed string. The same seed always returns the same users, which keeps test fixtures and screenshots stable.

Can I control nationality and gender?

Yes. Use `nat` with comma-separated country codes and `gender` set to male or female. Generated names, addresses and photos stay internally consistent with the nationality.

Are the profile photos real people?

They come from a fixed set of portrait images bundled with the service. Do not treat them as photos of real, identifiable individuals with rights clearance for every context.

Tools that pair with this API

JSON Formatter

Format, beautify and minify JSON online with 2-space, 4-space or tab indentation. Sort keys alphabetically and catch syntax errors instantly — free and private.

Password Generator

Generate strong random passwords with cryptographically secure randomness. Choose length and character sets, see entropy strength, copy instantly.

UUID Generator

Generate 1–100 cryptographically random UUID v4 identifiers at once. Uppercase and hyphen-less options, per-item copy and copy-all. Free UUID generator.

Random User Generator is an independent third-party service and is not affiliated with ByteTools or ByteVancer. Details on this page were verified on 2026-08-19; always check the official documentation before relying on this API in production, as terms and limits can change.