Random User Generator

aid: randomuser
name: Random User Generator
description: >-
  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: https://randomuser.me
image: https://randomuser.me/img/logo.png
specificationVersion: '0.20'
created: '2026-05-28'
modified: '2026-05-29'
x-source: public-apis/public-apis
x-category: Test Data
x-type: opensource
x-tier: 2
x-tier-reason: enriched-full-pipeline
tags:
  - Test Data
  - Synthetic Data
  - Mock Data
  - Open Source
  - Public API
  - Free API
apis:
  - aid: randomuser:randomuser
    name: Random User Generator API
    description: >-
      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).
    humanURL: https://randomuser.me
    baseURL: https://randomuser.me/api
    tags:
      - Test Data
      - Synthetic Data
    properties:
      - type: Documentation
        url: https://randomuser.me/documentation
      - type: APIReference
        url: https://randomuser.me/documentation
      - type: OpenAPI
        url: openapi/randomuser-openapi.yml
      - type: JSONSchema
        url: json-schema/randomuser-user-schema.json
        title: User Schema
      - type: JSONSchema
        url: json-schema/randomuser-user-response-schema.json
        title: User Response Schema
      - type: JSONStructure
        url: json-structure/randomuser-user-structure.json
      - type: JSONLD
        url: json-ld/randomuser-context.jsonld
      - type: Example
        url: examples/randomuser-generate-users-example.json
        title: Generate Users
      - type: Example
        url: examples/randomuser-paginated-seed-example.json
        title: Paginated Seeded Request
      - type: Example
        url: examples/randomuser-csv-export-example.json
        title: CSV Export with Download Flag
      - type: RateLimits
        url: rate-limits/randomuser-rate-limits.yml
      - type: Plans
        url: plans/randomuser-plans-pricing.yml
      - type: Authentication
        url: https://randomuser.me/documentation
        title: None (Public, Unauthenticated)
      - type: Versioning
        url: https://randomuser.me/documentation#versioning
      - type: ChangeLog
        url: https://randomuser.me/changelog
common:
  - type: Website
    url: https://randomuser.me
  - type: Documentation
    url: https://randomuser.me/documentation
  - type: ChangeLog
    url: https://randomuser.me/changelog
  - type: GitHubOrganization
    url: https://github.com/RandomAPI
  - type: GitHubRepository
    url: https://github.com/RandomAPI/Randomuser.me-Node
    title: Randomuser.me-Node (Canonical Source)
  - type: GitHubRepository
    url: https://github.com/RandomAPI/Offline-RandomAPI
    title: Offline RandomAPI npm module
  - type: GitHubRepository
    url: https://github.com/RandomAPI/Randomuser.me-module
    title: Offline User Generation Module
  - type: X
    url: https://twitter.com/randomapi
  - type: Pricing
    url: https://randomuser.me/#donate
    title: Free (Donation-Funded)
  - type: Support
    url: https://github.com/RandomAPI/Randomuser.me-Node/issues
  - type: PublicAPIsListing
    url: https://github.com/public-apis/public-apis
  - type: SpectralRules
    url: rules/randomuser-rules.yml
  - type: Vocabulary
    url: vocabulary/randomuser-vocabulary.yml
  - type: NaftikoCapability
    url: capabilities/shared/randomuser-users.yaml
    title: RandomUser Users (Shared)
  - type: NaftikoCapability
    url: capabilities/seed-test-fixtures.yaml
    title: Generate Deterministic Test Fixtures
  - type: NaftikoCapability
    url: capabilities/multi-nationality-cohort.yaml
    title: Build a Multi-Nationality User Cohort
  - type: Tools
    title: MCP Server (Community - pipeworx-io)
    url: https://github.com/pipeworx-io/mcp-randomuser
  - type: Tools
    title: MCP Server (Community - hugo-85)
    url: https://github.com/hugo-85/mcp-randomuserme
  - type: Tools
    title: MCP Server (Community - rycid)
    url: https://github.com/rycid/randomuserMCP
  - type: Features
    data:
      - name: Free and unauthenticated
        description: No API key, no signup, no per-key quotas; just hit the endpoint.
      - name: Seedable reproducibility
        description: The same (seed, page, results, version) tuple always returns the same users.
      - name: Multi-nationality cohort
        description: Mix 21 nationalities (v1.4) so addresses, IDs, and phone formats stay locale-appropriate.
      - name: Field projection
        description: Use `inc` / `exc` to keep payloads small and skip CPU-heavy fields like `login`.
      - name: Multi-format output
        description: JSON, PrettyJSON, CSV, YAML, XML; plus JSONP via `callback`.
      - name: Path-pinned versioning
        description: Lock requests to /1.0/ through /1.4/ so upstream releases never break your fixtures.
      - name: Pre-generated portrait images
        description: Three resolutions (large, medium, thumbnail) hosted on randomuser.me.
      - name: Open source
        description: MIT-licensed Node.js codebase; self-hostable if you need air-gapped operation.
  - type: UseCases
    data:
      - name: Frontend prototyping
        description: Populate UI mockups, design comps, and Storybook fixtures with realistic users.
      - name: Test data for QA / CI
        description: Generate seeded fixtures for unit, integration, and snapshot tests.
      - name: Load testing
        description: Bulk-generate up to 5000 users per request to seed performance test runs.
      - name: i18n / localization
        description: Request specific nationalities to validate address parsing, phone formats, and Unicode rendering.
      - name: Demo content
        description: Populate sales demos, sandbox environments, and tutorials with realistic-looking accounts.
      - name: Avatar placeholders
        description: Use the picture URLs as throwaway avatars for prototyping.
  - type: Integrations
    data:
      - name: jQuery / AJAX
        description: Documented usage with $.ajax for browser-side fetches.
      - name: Node.js
        description: Use directly from server-side JavaScript; offline module available.
      - name: Photoshop Extension
        description: Pull synthetic users straight into design comps (legacy extension).
      - name: Sketch Extension
        description: Sketch plugin for filling layers with random users (legacy).
      - name: Model Context Protocol
        description: Multiple community MCP servers expose the API to LLM agents (pipeworx-io, hugo-85, rycid).
  - type: Solutions
    data:
      - name: Hosted API
        description: Free, public, donation-funded endpoint at randomuser.me/api.
      - name: Offline npm module
        description: Generate the same shape of users without network calls using the offline RandomAPI module.
      - name: Self-hosted
        description: Clone Randomuser.me-Node and run the generator inside your own infrastructure.
maintainers:
  - FN: Kin Lane
    email: [email protected]