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": 380394070,
    "maxScore": 1.0,
    "queryTime": 2441,
    "page": 1,
    "pageSize": 10
  },
  "results": [
    ...
  ]
}

The header contains:

• numFound: total number of matching research products
• maxScore: maximum relevance score — only returned when results are ranked by relevance (omitted when sortBy uses another field)
• 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 (not just the current page):

• totalCitationsCount: total number of citations across all matching research products
• countsByType: breakdown of the result count by research product type

Example — /v3/research-products?search=covid&includeStats=true:

{
  "header": {
    "numFound": 1687614,
    "maxScore": 5.042736,
    "queryTime": 394,
    "page": 1,
    "pageSize": 10,
    "totalCitationsCount": 13107275,
    "countsByType": {
      "publication": 1544760,
      "other": 83686,
      "dataset": 55356,
      "software": 3812
    }
  },
  "results": [
    ...
  ]
}

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