Random User Generator

aid: randomuser
name: Random User Generator
description: 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).
url: https://raw.githubusercontent.com/api-evangelist/randomuser/refs/heads/main/apis.yml
accessModel:
  pricing: free
  onboarding: open
  trial: false
  try_now: true
  public: true
  label: Free · Open access
  confidence: medium
  source:
  - plans
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/randomuser.png
specificationVersion: '0.19'
created: '2026-06-13'
modified: '2026-06-13'
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-users-api
  name: Random User Generator Users API
  description: Generate one or more synthetic user records.
  humanURL: https://randomuser.me
  baseURL: https://randomuser.me/api
  tags:
  - Users
  properties:
  - type: OpenAPI
    url: openapi/randomuser-users-api-openapi.yml
  - type: Documentation
    url: https://randomuser.me/documentation
  - type: APIReference
    url: https://randomuser.me/documentation
  - type: JSONSchema
    url: json-schema/randomuser-user-schema.json
  - type: JSONSchema
    url: json-schema/randomuser-user-response-schema.json
  - type: JSONStructure
    url: json-structure/randomuser-user-structure.json
  - type: JSONLD
    url: json-ld/randomuser-context.jsonld
  - type: Examples
    url: examples/randomuser-generate-users-example.json
  - type: Examples
    url: examples/randomuser-paginated-seed-example.json
  - type: Examples
    url: examples/randomuser-csv-export-example.json
  - type: RateLimits
    url: rate-limits/randomuser-rate-limits.yml
  - type: Plans
    url: plans/randomuser-plans-pricing.yml
  - type: Authentication
    url: https://randomuser.me/documentation
  - type: Versioning
    url: https://randomuser.me/documentation#versioning
  - type: ChangeLog
    url: https://randomuser.me/changelog
common:
- type: AgenticAccess
  url: agentic-access/randomuser-agentic-access.yml
- type: DomainSecurity
  url: security/randomuser-domain-security.yml
- type: Website
  url: https://randomuser.me
- type: Documentation
  url: https://randomuser.me/documentation
- type: ChangeLog
  url: https://randomuser.me/changelog
- type: GitHubOrg
  url: https://github.com/RandomAPI
- type: GitHubRepository
  url: https://github.com/RandomAPI/Randomuser.me-Node
  title: Randomuser.me-Node (Canonical Source)
- type: X
  url: https://twitter.com/randomapi
- type: Pricing
  url: https://randomuser.me/#donate
  title: Free (Donation-Funded)
- type: Plans
  url: plans/randomuser-plans-pricing.yml
- type: RateLimits
  url: rate-limits/randomuser-rate-limits.yml
- type: FinOps
  url: finops/randomuser-finops.yml
- type: Support
  url: https://github.com/RandomAPI/Randomuser.me-Node/issues
- 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: kin@apievangelist.com