GET/v2/randomuser

Get fake random user profiles

Generates fake user profiles such as name, email, address and username for testing or placeholders, with count, gender, age, locale, field selection and seed options.

API Ninjas·$0.001 per call

Example code

// Using @orth/sdk - The simplest way to call APIs
// Install: npm install @orth/sdk
import Orthogonal from "@orth/sdk";

const orthogonal = new Orthogonal({
  apiKey: process.env.ORTHOGONAL_API_KEY,
});

const output = await orthogonal.run({
  api: "api-ninjas",
  path: "/v2/randomuser"
});

console.log(output);

Query parameters

count

number

Number of users to generate (1-10000) (Default: 10)

gender

string

Filter by gender (Allowed: male, female, nonbinary, any) (Default: any)

min_age

number

Minimum age (0-115) (Default: 0)

max_age

number

Maximum age (0-115) (Default: 100)

locale

string

Locale for generating localized data (e.g., en_US, de_DE, fr_FR) (Default: en_US)

fields

string

Comma-separated list of fields to include. If not specified, all available fields are returned.

exclude

string

Comma-separated list of fields to exclude from the response

seed

string

Seed value for reproducible random data generation

blank_percentage

number

Percentage of fields to leave blank (0-100) (Default: 0)

password_length

number

Length of generated passwords (6-128) (Default: 12)

nationality

string

Nationality filter (Default: any)