DataCite Support

DataCite Support

Welcome to DataCite's support site. Here you will find helpful information about our services. We have included comprehensive technical guides, training materials, and tips to help you successfully use DataCite services.

Get Started    API Reference

Retrieving a random sample of DOIs

Being able to select random results is useful for both testing and sampling. You can use the random parameter to retrieve a set of random results. For example, the following would select 10 random works from among all DataCite records:

$ curl https://api.test.datacite.org/dois?random=true&page[size]=10

The random parameter can be combined with any kind of query, for example:

$ curl https://api.test.datacite.org/dois?query=climate%20change&random=true&page[size]=10

Note that when you use the random parameter, the page[number] parameters is ignored. The page[size] parameter can be any number between 1 and 100.

Sample Group

Samples can be grouped:

$ curl https://api.test.datacite.org/dois?sample=10&sample-group=client&page[size]=20

This query will retrieve 10 samples per client, for 20 clients. Allowed parameters for sample-group are client, provider and resource-type.

Updated 12 months ago

Retrieving a random sample of DOIs


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.