Research Products

Search and retrieve research outputs — publications, datasets, software, and other research products.

Base URL

https://api-beta.openaire.eu/graph/v4/research-products

Quick start

Get peer-reviewed open-access publications about climate change, sorted by citation count:

/v4/research-products?search=climate change&filter=type:publication,is_peer_reviewed:true,best_oa.rights:Open Access&sort=citation_count:desc

Parameters

Parameter	Type	Default	Description
filter	string	—	Comma-separated field:value predicates (see filter syntax)
search	string	—	Full-text keyword search across title and abstract
sort	string	relevance:desc	Comma-chained field:direction directives (see sorting)
select	string	(full object)	Comma-separated response fields to return (see sparse fieldsets)
facets	string	—	Records + facet counts (see aggregations)
group_by	string	—	Facets-only mode, no records (see aggregations)
page	int	1	Page number (see paging)
page_size	int	10	Results per page, range 1–100
cursor	string	—	Cursor-based pagination (see cursor paging)
mailto	string	—	Contact email for the polite pool / higher-rate tier

Response

The response is an object with a header and a results array:

{
  "header": {
    "numFound": 351000000,
    "maxScore": 12.34,
    "queryTime": 150,
    "page": 1,
    "pageSize": 10
  },
  "results": [
    ...
  ]
}

The header contains:

• numFound: total number of matching entities
• maxScore: maximum relevance score
• queryTime: time in milliseconds
• page: current page number (offset pagination)
• pageSize: number of results per page
• nextCursor: next page token (cursor pagination)

The results array contains Research product objects.

When aggregations are requested, an additional facets field is included in the response.

Learn more

• Filter syntax — the unified filter= parameter with all available fields
• Sorting and paging — sort fields, offset and cursor pagination
• Aggregations — facets and group_by modes
• Sparse fieldsets — the select= parameter for reducing response size
• Examples — ready-to-use API calls for every parameter and filter