Skip to content

api-evangelist/randomuser

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Random User Generator (randomuser)

Free, open-source REST API that generates rich, realistic synthetic user records (name, location, login, contact, picture, identification, nationality) for application testing, prototyping, and demo content. Powered by the open-source Randomuser.me-Node project under the MIT license and funded by community donations. Single unauthenticated GET endpoint, seedable for reproducibility, with multi-format output (JSON, PrettyJSON, CSV, YAML, XML).

URL: Visit APIs.json URL

Run: Capabilities Using Naftiko

Tags

  • Test Data, Synthetic Data, Mock Data, Open Source, Public API, Free API

Timestamps

  • Created: 2026-05-28
  • Modified: 2026-05-29

Type

APIs

Random User Generator API

Single GET endpoint that returns a configurable batch of synthetic users. Supports up to 5000 results per request, multi-nationality mixing, field include/exclude projection, deterministic seeds with pagination, multiple serialization formats, and path-pinned versioning (1.0 - 1.4).

Human URL: https://randomuser.me

Base URL: https://randomuser.me/api

Tags

  • Test Data, Synthetic Data

Properties

Common Properties

Features

Name Description
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.

Use Cases

Name Description
Frontend prototyping Populate UI mockups, design comps, and Storybook fixtures with realistic users.
Test data for QA / CI Generate seeded fixtures for unit, integration, and snapshot tests.
Load testing Bulk-generate up to 5000 users per request to seed performance test runs.
i18n / localization Request specific nationalities to validate address parsing, phone formats, and Unicode rendering.
Demo content Populate sales demos, sandbox environments, and tutorials with realistic-looking accounts.
Avatar placeholders Use the picture URLs as throwaway avatars for prototyping.

Integrations

Name Description
jQuery / AJAX Documented usage with $.ajax for browser-side fetches.
Node.js Use directly from server-side JavaScript; offline module available.
Photoshop Extension Pull synthetic users straight into design comps (legacy extension).
Sketch Extension Sketch plugin for filling layers with random users (legacy).
Model Context Protocol Multiple community MCP servers expose the API to LLM agents (pipeworx-io, hugo-85, rycid).

Solutions

Name Description
Hosted API Free, public, donation-funded endpoint at randomuser.me/api.
Offline npm module Generate the same shape of users without network calls using the offline RandomAPI module.
Self-hosted Clone Randomuser.me-Node and run the generator inside your own infrastructure.

Artifacts

Machine-readable API specifications organized by format.

OpenAPI

JSON Schema

JSON Structure

JSON-LD

Examples

Capabilities

Naftiko capabilities organized as shared per-API definitions composed into customer-facing workflows.

Shared Per-API Definitions

Workflow Capabilities

Workflow APIs Combined Persona
Generate Deterministic Test Fixtures randomuser QA / Test Engineering
Build a Multi-Nationality User Cohort randomuser i18n / Localization Engineering

Vocabulary

  • RandomUser Vocabulary - Controlled vocabulary covering 2 operations, 3 entities, 12 request parameters, and 21 supported nationalities (v1.4) across the operational dimension.

Rules

  • RandomUser Spectral Rules - 10 rules enforcing operationId casing, Title Case summaries, tag presence, parameter enumerations, results cap, no-auth posture, HTTPS servers, User schema presence, and Microcks mocking metadata.

Plans & Rate Limits

  • Plans - Free, donation-funded, no commercial tier.
  • Rate Limits - No documented per-key or per-IP rate cap; hard 5000 results per request.

Maintainers

FN: Kin Lane

Email: kin@apievangelist.com

About

Free, open-source REST API that generates rich, realistic synthetic user records (name, location, login, contact, picture, identification, nationality) for application testing, prototyping, and demo content. Powered by the open-source Randomuser.me-Node project under the MIT license and funded by community donations. Single unauthenticated GET end…

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors