How to hit the Random User API

Random User Generator at https://randomuser.me/api returns realistic fake people — names, addresses, emails, photos — for seeding test data.

Authentication

None — no key, no signup. Every example runs as-is.

Full reference: https://randomuser.me/documentation

Generate a user

curl "https://randomuser.me/api/?nat=us"
Run in PostTaco
Example response (trimmed)
{
  "results": [
    {
      "gender": "female",
      "name": {
        "title": "Miss",
        "first": "Josephine",
        "last": "Sanders"
      },
      "location": {
        "street": {
          "number": 7770,
          "name": "Brown Terrace"
        },
        "city": "Roanoke",
        "state": "Nevada",
        "country": "United States",
        "postcode": 82278,
        "coordinates": {
          "latitude": "31.9529",
          "longitude": "1.3014"
        },
        "timezone": {
          "offset": "+5:00",
          "description": "Ekaterinburg, Islamabad, Karachi, Tashkent"
        }
      },
      "email": "[email protected]",
      "login": {
        "uuid": "7d2bc0b8-c3f7-4efa-bf6d-5e4828ce7ea0",
        "username": "ticklishfrog915",
        "password": "guitars",
        "salt": "o9E67PC0",
        "md5": "f578f44448fcecd2c9909fa0de193c8f",
        "sha1": "87167664a3dddac18082bb960f150f93cae8fb2b",
        "sha256": "54fa4f43143993783c5311b2a3013d29c40f418a2026a364e4a682506b38b179"
      },
      "dob": {
        "date": "1958-11-23T18:17:57.865Z",
        "age": 67
      },
      "registered": {
        "date": "2012-10-12T23:18:21.805Z",
        "age": 13
      },
      "phone": "(688) 596-0008",
      "cell": "(437) 949-5154",
      "id": {
        "name": "SSN",
        "value": "145-42-5235"
      },
      "picture": {
        "large": "https://randomuser.me/api/portraits/women/13.jpg",
        "medium": "https://randomuser.me/api/portraits/med/women/13.jpg",
        "thumbnail": "https://randomuser.me/api/portraits/thumb/women/13.jpg"
      },
      "nat": "US"
    }
  ],
  "info": {
    "seed": "43b455f75771083b",
    "results": 1,
    "page": 1,
    "version": "1.4"
  }
}

Pick fields and use a seed

inc keeps only the fields you list; the same seed always returns the same people.

curl "https://randomuser.me/api/?results=2&inc=name,email,location&seed=posttaco"
Run in PostTaco
Example response (trimmed)
{
  "results": [
    {
      "name": {
        "title": "Miss",
        "first": "Tammy",
        "last": "Jacobs"
      },
      "location": {
        "street": {
          "number": 7323,
          "name": "Victoria Street"
        },
        "city": "Nottingham",
        "state": "Shropshire",
        "country": "United Kingdom",
        "postcode": "RM36 1UQ",
        "coordinates": {
          "latitude": "-10.0514",
          "longitude": "14.5655"
        },
        "timezone": {
          "offset": "-5:00",
          "description": "Eastern Time (US & Canada), Bogota, Lima"
        }
      },
      "email": "[email protected]"
    },
    {
      "name": {
        "title": "Ms",
        "first": "Faith",
        "last": "Odonoghue"
      },
      "location": {
        "street": {
          "number": 3859,
          "name": "Jones Road"
        },
        "city": "Athlone",
        "state": "Louth",
        "country": "Ireland",
        "postcode": 92085,
        "coordinates": {
          "latitude": "35.1238",
          "longitude": "-40.6675"
        },
        "timezone": {
          "offset": "+11:00",
          "description": "Magadan, Solomon Islands, New Caledonia"
        }
      },
      "email": "[email protected]"
    }
  ],
  "info": {
    "seed": "posttaco",
    "results": 2,
    "page": 1,
    "version": "1.4"
  }
}