API overview

Intro to Rest APIs

The data.world API (Application Programming Interface) is built around REST (Representational State Transfer). REST APIs allow data.world (and other programs) to make functionality and data available to other programs for consumption in a consistent format.

data.world's API is built around predictable URLs and HTTP response codes help surface any errors that may occur, so you can quickly make changes and continue.

Want to know what you can do with the API? Use it to upload & download data, get user information, create Insights, query datasets, and send notifications, and more.

Check out our API Reference for the full list of endpoints.


An overview of data.world APIs

data.world uses common HTTP methods to access resources:

GETUsed to retrieve information/data. Can be used safely as it does not alter resources.Retrieve datasets, download files, retrieve user data.
POSTUsed to create new data on a server. POST methods will have side-effects as they do alter resourcesCreate a dataset, query via SQL or SPARQL, upload & sync files.
PUTUsed to replace existing data.Replace an insight, subscribe to a dataset or project, link a dataset.
PATCHUsed to update existing data. See this section for more details.Update a resource such as insight or dataset.
DELETEUsed to remove resources from a server.Delete a dataset or project, delete files, unsubscribe from dataset, unlink a dataset.


Important things to note about the PATCH method

  • Only elements included in the request will be updated. All omitted elements will remain untouched.
  • Requesting an element to be null deletes all values on the element.
  • Requesting change in a list replaces the entire list.