Graph API
The OpenAIRE Graph API provides a comprehensive way to explore the OpenAIRE Graph, a vast interconnected dataset that aggregates metadata from a wide range of scholarly resources. The OpenAIRE Graph API offers endpoints for accessing and querying this interconnected dataset, enabling users to retrieve detailed information on research products, data sources, organizations, projects, and persons.
Base URL
https://api.openaire.eu/graph/
Two ways to query
The same entities (research products, data sources, organizations, projects and persons) are available through two different query styles. They are separate sets of endpoints, each with its own documentation section — pick the one that fits your use case:
Use filter-based queries (V4) for new integrations. Parameter-based queries (V3) are mainly kept for existing integrations, for backward compatibility.
| Filter-based queries (V4) | Parameter-based queries (V3) | |
|---|---|---|
| Status | recommended for new integrations | backward compatibility |
| How you filter | a single filter expression | one query parameter per filter |
| Example | ?filter=type:publication,from_publication_year:2023 | ?type=publication&fromPublicationYear=2023 |
| Faceted counts | aggregations | — |
| Choosing response fields | select | — |
| Reference | Swagger (V4) | Swagger (V3) |
Filter-based queries collapse every filter into one compact filter expression, and additionally offer faceted counts and response-field selection. To move an existing integration across, see Migration from parameter-based queries.
Parameter-based queries use one query parameter per filter. This is the style carried over from the earlier versions of the API, so it is the closest match if you maintain an existing integration.
Notes
Please note that the Graph API:
- limits offset-based paging to 10,000 results per query. For complete dataset access, use cursor-based paging — see Paging for parameter-based queries and Sorting and paging for filter-based ones — or download the full OpenAIRE Graph dataset.
- adheres to the terms of use of the OpenAIRE public APIs — certain (rate limit) restrictions apply. For higher limits, see Authenticated access.