smartAPI: Towards a more intelligent network of Web APIs

Amrapali Zaveri*, Shima Dastgheib, Trish Whetzel, Ruben Verborgh, Paul Avillach, Gabor Korodi, Raymond Terryn, Kathleen M Jagodnik, Pedro Assis, Chunlei Wu, Michel Dumontier

*Corresponding author for this work

Research output: Chapter in Book/Report/Conference proceedingConference article in proceedingAcademicpeer-review


Data science increasingly employs cloud-based web application programming interfaces (apis). However, automatically discovering and connecting suitable apis for a given application is difficult due to the lack of explicit knowledge about the structure and datatypes of web api inputs and outputs. To address this challenge, we conducted a survey to identify the metadata elements that are crucial to the description of web apis and subsequently developed the smartapi metadata specification and associated tools to capture their domain-related and structural characteristics using the fair (findable, accessible, interoperable, reusable) principles. This paper presents the results of the survey, provides an overview of the smartapi specification and a reference implementation, and discusses use cases of smartapi. We show that annotating apis with smartapi metadata is straightforward through an extension of the existing swagger editor. By facilitating the creation of such metadata, we increase the automated interoperability of web apis. This work is done as part of the nih commons big data to knowledge (bd2k) api interoperability working group.
Original languageEnglish
Title of host publicationProceedings of the 14th ESWC
EditorsEva Blomqvist, Diana Maynard, Aldo Gangemi, Rinke Hoekstra, Pascal Hitzler, Olaf Hartig
Number of pages16
ISBN (Print)978-3-319-58451-5
Publication statusPublished - 1 May 2017

Publication series

SeriesLecture Notes in Computer Science

Cite this