Private BetaFound a bug or have feedback? Share it →

Random User

Generate realistic random user profiles with names, addresses, photos, and contact info. Filter by nationality. Free, no key required. Ideal for test data and prototyping.

Healthy
Developer ToolsNo upstream key required

Base URL

https://api.apiclearinghouse.com/v1/call/random-user

Authenticate with X-Api-Key: chk_live_... header.

GET/generate

Generate random user profiles

Parameters

NameTypeRequiredDescription
countnumberoptionalNumber of profiles to generate (1–10, default 1)(default: 1)
nationalitystringoptionalNationality code: us, gb, au, ca, de, fr, etc.(default: us)

Example Request

curl -s "https://api.apiclearinghouse.com/v1/call/random-user/generate?count=1&nationality=us" \
  -H "X-Api-Key: YOUR_API_KEY"

Example Response

{
  "status": "success",
  "data": {
    "users": "example"
  }
}

Try it live

No setup required. Sign in and run Random User directly from your browser.

Open in Explorer →

Rate Limits

Free10/min
Pro100/min
Elite500/min

Monthly limits also apply per plan.

Authentication

Pass your API key in the request header:

X-Api-Key: chk_live_...
Join the beta
← Back to catalog
random-user API Documentation — API Clearinghouse