Filter-based Queries
This section documents the filter-based style of the Graph API: instead of a separate query parameter for each filter, you express all of them in a single filter parameter using a compact field:value syntax.
https://api.openaire.eu/graph/v4/research-products?filter=type:publication,from_publication_year:2023
Alongside the filter syntax, these endpoints add faceted counts and response-field selection, which the parameter-based endpoints do not offer.
New here? Jump to the Quickstart.
Endpoints
| Entity | Search endpoint | Covers |
|---|---|---|
| Research Products | GET /v4/research-products | publications, datasets, software, other |
| Organizations | GET /v4/organizations | universities, research organizations, funders, companies |
| Data Sources | GET /v4/datasources | repositories, journals, aggregators, funder databases |
| Projects | GET /v4/projects | funded research project grants |
| Persons | GET /v4/persons | authors and contributors |
note
There are no single-entity endpoints here. To retrieve one record, filter on its identifier — filter=id:{id} — as shown in the Quickstart.
Current version
The current version of the filter-based API is V4, served under /v4 and documented throughout this section. You can access the Swagger documentation at Swagger UI.
Cross-cutting topics
- Migration from Parameter-based Queries — mapping each parameter to its
filterequivalent - Glossary — terminology reference
- Changelog — what changed in each release