Skip to content

Have you ever looked at the ‘Get an API token’ option on the object search pageand wondered how you could use that? Charlotte Sadler explains two options for using an Extract API token to download data from MDS… 

If you search for objects on the MDS website, you’ll see a text that says ‘Get an API token’. Clicking on that opens a form that asks for a few details, and once you’ve accepted the API terms of use, you can ‘Get API token’ – that’s all that’s required to use our Extract API!  

There are 2 tools that you can use to download MDS data with an Extract API token:  

Both tools have slightly different applications, but they support users in getting large amounts of data out of the MDS for analysis and reuse. 

The MDS Data Fetcher helps users get data out of MDS search results quickly and easily, while the MDS Exporter supports more advanced and large-scale export workflows. Together they represent different stages of data maturity: from exploratory access to repeatable and resilient data extraction. 

What tool is best for what task? 

  • If you want to search collections, try the MDS Object Search first (no tool needed). 
  • To download more than 1000 search results, use the MDS Data Fetcher. 
  • To download 1000 or fewer search results, download a summary of Object Search results in CSV (simple spreadsheet) format 
  • To retrieve larger datasets reliably, use the MDS Exporter. 
  • If you want to build automated workflows with the data, try the MDS Exporter with customised scripts. 

If you’re wanting a set of records that match specific criteria, you’ll most likely want to use the Data Fetcher. If you want to obtain larger exports reliably, you’ll most likely want to use the MDS Exporter. 

MDS Data Fetcher – just copy and paste your token, and choose to export as CSV or JSON 

Use this online service with the Extract API token for your search. The Data Fetcher retrieves all pages of the search results and you can download them as one JSON or CSV file. 

MDS Exporter – if you’re comfortable using pip or uv to get and run Python code 

This is a command-line interface (CLI) tool that manages resume API tokens. It downloads data using the MDS Export API, and can restart or resume interrupted exports. It’s more robust for exporting lots of results. 

Sign up to our newsletter

Follow the latest MDS developments every two months with our newsletter.

Unsubscribe any time. See our privacy notice.

Back to top