chevron-down chevron-right chevron-up comment dropdown facebook folder google-plus label linkedin github loupe next perk-01 perk-02 perk-03 perk-04 perk-05 perk-06 perk-07 perk-08 pin previous twitter

Random Things: an API for generating data as real as the Upside-Down

A lot goes into building meaningful synthetic datasets, and we’ll be using this blog as a medium to explore the many topics. One piece of the puzzle is the ability to identify various types of data and then generate random data specific to each type. Today, we’re releasing our API for generating random things to help others in their endeavors to create synthetic data.

Currently the API supports generating:

  1. Addresses
  2. Names
  3. Phone Numbers
  4. MAC and IP Addresses
  5. Social Security Numbers

Take it for a spin at Each API call is a GET method that allows you to generate up to 10,000 items per request (adjusted via the amount query parameter). If you’re more the command-line type, here are a few cURL requests to get you started:

curl -i “ address_type=city_state_zip&amount=100

This will generate 100 city,state,zip tuples. Locations are generated by sampling from population distributions so you’re more likely to obtain locations that are more populated.

curl -i “

This will generate 100 social security numbers.

curl -i “

This will generate 10 US phone numbers of the format (xxx)-xxx-xxxx, e.g., (404)-555-5555. Note that the round brackets enclosing the area code are URL-encoded.

As always, if you have any questions about synthetic data or its many use cases, don’t hesitate to reach out to us at Additionally, if there’s a particular data type that you’d like us to add to this API, let us know, and we’ll do our best to add it soon.

Want to learn more? Subscribe!