List random profiles

get/v1/profiles

Request

  • Base URL: https://random-profiles.com
  • URL: https://random-profiles.com/v1/profiles
  • Auth: API key in header X-API-Key

Query parameters

countinteger

Number of profiles to return

photo_size64 | 128 | 256 | 512 | 1024

Photo size in pixels

photo_format'jpg' | 'webp'

Image format for the photo URL. WebP is ~30% smaller with the same perceived quality.

fieldsstring

Comma-separated field groups to return (name,email,phone,identity,bio,social,physical,job,address,financial,network,documents,vehicle,contact,digital,interests,education,photo)

gender'male' | 'female' | 'non-binary'

Filter by gender

countrystring

Comma-separated country codes to include (US, GB, DE, FR, AU, BR, JP, IN, NG)

exclude_countrystring

Comma-separated country codes to exclude

min_ageinteger

Minimum age filter

max_ageinteger

Maximum age filter

seedinteger

Seed for deterministic results — same seed returns same profiles

format'json' | 'csv'

Response format (json or csv)

Response

List of profiles

Changes

No recorded changes to this operation across all 1 revision of this API.