Research Products

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

Base URL

https://api.openaire.eu/graph/v3/research-products

Quick start

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

/v3/research-products?search=climate change&type=publication&isPeerReviewed=true&sortBy=citationCount DESC

Retrieve a single research product by its OpenAIRE id:

/v3/research-products/doi_dedup___::a55b42c0d32a4a24cf99e621623d110e

Endpoints

• GET /v3/research-products — search research products using the filter parameters
• GET /v3/research-products/{id} — retrieve a single research product by its OpenAIRE id

Meta-parameters

These parameters control searching, sorting, paging, and the response shape. All filter parameters are documented separately.

Parameter	Type	Default	Description
search	string	—	Keyword-based search across the research product's content
logicalOperator	string	AND	Top-level operator combining the provided filters (AND or OR)
includeStats	boolean	false	Include aggregate statistics in the response header (see below)
sortBy	string	relevance DESC	Sort directive fieldname ASC\|DESC (see sorting)
page	int	1	Page number (see paging)
pageSize	int	10	Results per page, range 1–100
cursor	string	—	Cursor-based pagination, initial value * (see cursor paging)

Response

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

{
  "header": {
    "numFound": 36818386,
    "maxScore": 1,
    "queryTime": 21,
    "page": 1,
    "pageSize": 10
  },
  "results": [
    ...
  ]
}

The header contains:

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

The results array contains Research product objects.

Statistics

When includeStats=true, the response header additionally reports aggregate statistics about the full result set — the total citation count and the breakdown of the result count by research product type (publication, dataset, software, other).

Learn more

• Filtering — all available filter parameters and logical operators
• Sorting — sort fields and direction
• Paging — offset and cursor pagination
• Examples — ready-to-use API calls for every parameter