Documentation
Parameters
All `GET /people` parameters are optional. Unknown, repeated or incompatible values are rejected.
Available filters
| Parameter | Value | Purpose |
|---|---|---|
| count | 1–100 · default 1 | Number of profiles |
| gender | male, female | Gender |
| ageGroup | child, teen, adult, senior | One or more comma-separated groups |
| nationality | Two-letter ISO code | Nationality with a reviewed name pool |
| residenceCountry | Two-letter ISO code | Country with an available city |
| continent | africa, americas, asia, europe, oceania | Limits nationalities |
| city | City in residence country | Requires a country |
| emailDomain | ASCII domain · default example.test | Generated email domain |
| seed | 1–128 characters | Generation seed |
| asOf | YYYY-MM-DD | UTC reference date |
| fields | Comma-separated paths | Select returned fields |
Age groups
The groups are child (6–12), teen (13–17), adult (18–64) and senior (65–100). Distinct values can be combined: ageGroup=adult,senior.
Select fields
fields selects properties of each person. results and meta remain. Without it, all public fields except login are included.
HTTP
GET /people?fields=name.first,location.city,location.coordinates.latitude,picture.thumbnailA parent/child combination such as name,name.first returns 400. The encoded query string is limited to 2,048 characters.