Skip to main content
Version: 8.0.0

Sorting and paging

The OpenAIRE Graph API allows you to sort and page through the results of your search queries. This enables you to retrieve the most relevant results and manage large result sets more effectively.

Sorting

Sorting based on specific fields, helps to retrieve data in the preferred order. Sorting is achieved using the sortBy parameter, which specifies the field and the direction (ascending or descending) for sorting.

  • sortBy: Defines the field and the sort direction. The format should be fieldname sortDirection, where the sortDirection can be either ASC for ascending order or DESC for descending order.

The field names that can be used for sorting are specific to each entity type and can be found in the sortBy field values of the available paremeters.

Note that the default sorting is based on the relevance score of the search results.

Examples:

Note that you can combine multiple sorting conditions by separating them with a comma.

Example:

Paging

The OpenAIRE Graph API supports paging through the use of page and pageSize parameters, enabling you to specify which part of the result set to retrieve and how many results per page.

  • page: Specifies the page number of the results you want to retrieve. Page numbering starts from 1.

  • pageSize: Defines the number of results to be returned per page. This helps limit the amount of data returned in a single request, making it easier to process.

Example: