The Open Humans public data API allows you to retrieve JSON representations of data shared publicly by Open Humans members, including URLs to download that data.

if you plan to use public data, please read our guidelines for using public data.

Instructions

The base URL for the API is https://www.openhumans.org/api/public-data/.

Because the API only returns public data no authentication is required.

The API uses pagination via the offset querystring parameter; the default page size is 100 results. A smaller or larger page size can be specified with the limit parameter.

You may filter the results with these querystring parameters:

  • created_start the start date to filter from (inclusive)
  • created_end the end date to filter to (inclusive)
  • source the name of a data souce, like pgp or american_gut, or a comma-separated list of sources, like pgp,american_gut.
  • username a username, like mpball
  • member_id an Open Humans member ID, like 94621811

Examples

This query searches for the 5 most recently updated data files from user mpball:

https://www.openhumans.org/api/public-data/?username=mpball&limit=5

This query shows all Harvard Personal Genomes Project data updated on 2/14/2016:

https://www.openhumans.org/api/public-data/?created_start=2/14/2016&created_end=2/14/2016&source=pgp

Which users have which sources?

There are also two ways to see which users have which data sources:

Query for a specific data type

Create a search URL for a specific data type:

URL: