Skip to main content

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:

Recommended

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)
Statusrecommended for new integrationsbackward compatibility
How you filtera single filter expressionone query parameter per filter
Example?filter=type:publication,from_publication_year:2023?type=publication&fromPublicationYear=2023
Faceted countsaggregations—
Choosing response fieldsselect—
ReferenceSwagger (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: