AIDS.GOV | SERVICE LOCATOR | SEARCH

BLOG.AIDS.GOV

MENU

Open Data in Action: What is an API?

Listen:

Javascript and flash are required to play this audio file.

Download MP3

In the past, information or data sharing typically required a fee or specific agreements. For example, if you wanted to get content from a news article, you had to buy a newspaper. Technology has changed how we share information: it has removed barriers and created incentives for open data sharing.

One way that online data can be made more available is through an “application programming interface” or API. While the name may be intimidating, you probably use APIs every day. APIs bring us real-time news, weather, and photosharing.

At the Health Experience Design Conference Exit Disclaimer last week Todd Park, former Chief Technology Officer at HHS and newly appointed CTO to the President, spoke of the benefits of “liberating data.” APIs make data more accessible by making them “machine-readable,” in a format that is downloadable, free, and easy to find. The U.S. government is making more and more health data available so “innovators can turn it into public data that…improves health.” The Community Health Data Initiative aims to be the “NOAA of health data.” The National Oceanic and Atmospheric Association’s (NOAA) weather data provides data about the weather that is accessible through an API. In turn, others generate their own products, such as weather newscasts, websites, widgets, and apps. In other words, they encourage individuals and organizations to take their data and create new products that best serve their audiences.

Healthfinder is an example of a government health agency’s API. Their Quick Guide to Healthy Living API provides developers the latest version of the healthfinder.gov Quick Guide to Healthy Living content. This API allows developers flexibility to create customized products. To assist with this process, they have made the same content and updates available via content syndication for users with less web development experience or fewer resources. Another example of a health API is PatientsLikeMe Exit Disclaimer, who has used the clinicaltrials.gov  API to help patients find clinical trials that are right for them and help companies find patients who are right for their trials.

AIDS.gov recently made the information from the HIV/AIDS Service Provider Locator available by creating an API. Currently the HIV/AIDS Service Provider Locator allows individuals and providers to enter a ZIP code and find federally-funded HIV testing and care-related services within a selected mile radius. We hope that organizations and individuals will find innovative ways to use the HIV/AIDS Locator’s API data (service provider names, addresses, phone numbers, locations and so on, categorized by service type) on websites, apps, and databases to connect people to prevention and treatment services.

Whatever you can dream of doing with this public data, it’s yours to use. We are excited to see what you come up with!

In part two of this series you will learn more about the AIDS.gov Locator API and how it might be used in the response to HIV.

Let us know what questions you have about APIs and we will try to answer them in our next post. We would also be interested in hearing your ideas for the AIDS.gov HIV/AIDS Service Locator API. If you have used APIs before please share your experience in the comments.

Comments

  1. Brian Thomason says:

    Since many states require HIV+ reporting by name, instead of a code, will folks be able to hack in and retrieve all of the HIV+ citizens and their data?

    • Michelle Samplin-Salgado says:

      Hi Brian,
      Thanks for your question. The information provided in the HIV Locator API contains data about the location of HIV testing and services across the country. It does not contain any information about people living with HIV. Please let us know if you have any additional questions or concerns.
      - The AIDS.gov Team

  2. Stephanie says:

    Is this API language-independent? If not, what language must be used to call it?

    • Michelle Samplin-Salgado says:

      Stephanie,

      Yes, the API is completely language independent. It accepts requests over HTTP, and responds with either JSON-formatted output, or HTML, depending on the ‘format’ parameter. For more details, check out http://aids.gov/locator/api, and look for our upcoming post with more details.

      AIDS.GOV

  3. Dano says:

    If possible, it would be great to add HIV test sites and other services in tribal territories to the HIV/AIDS Locator API.

  4. Mark Sapita says:

    I teach health in a secondary school.
    Any thoughts on how this could be used in the classroom?

    • Michelle Samplin-Salgado says:

      Mark,

      The developer of the API encourages you to use our API to talk to your students about how open data can be used to combat health issues, maybe even working a project with your students to develop a mash-up between our data and some other available data, maybe from http://health.data.gov or elsewhere. Let us know what you end up doing and how we can help.

      - AIDS.gov Team

Speak Your Mind

*