openaire-graph-docs/docs/apis/graph-api/graph-api.md

33 lines
2.0 KiB
Markdown
Raw Normal View History

# Graph API <span class="theme-doc-version-badge badge badge--secondary">beta</span>
2024-07-05 16:55:58 +02:00
The OpenAIRE Graph API provides a comprehensive way for developers to explore the [OpenAIRE Graph](https://graph.openaire.eu/), a vast interconnected dataset that aggregates metadata from a wide range of scholarly resources.
2024-07-09 15:49:51 +02:00
The Graph API offers endpoints for accessing and querying this interconnected dataset, enabling users to retrieve detailed information on research products, data sources, organizations, and projects.
2024-07-05 16:55:58 +02:00
2024-07-05 18:38:08 +02:00
## Base URL and Swagger documentation
2024-07-05 16:55:58 +02:00
2024-07-05 18:38:08 +02:00
The base URL of the Graph API is:
```
https://api-beta.openaire.eu/graph/
2024-07-05 18:38:08 +02:00
```
2024-07-05 16:55:58 +02:00
You can access the API Swagger documentation in [https://api-beta.openaire.eu/graph/swagger-ui/index.html#/](https://api-beta.openaire.eu/graph/swagger-ui/index.html#/).
2024-07-05 18:38:08 +02:00
## Notes
2024-07-05 16:55:58 +02:00
Please note that the Graph API:
2024-07-13 21:16:05 +02:00
- is intended for data discovery and exploration, hence you are now allowed to navigate the full result set: you are limited to the first 10,000 results of a search query. If you are interested to access the whole graph, we encourage you to download the [OpenAIRE full Graph dataset](../../downloads/full-graph.md).
2024-07-05 16:55:58 +02:00
- adhers to the [terms of use](../terms.md) of the OpenAIRE public APIs - certain (rate limit) restrictions apply.
## Learn more
Please use the following links to learn more about the Graph API:
2024-07-12 16:21:11 +02:00
- [Getting a single entity](./getting-a-single-entity.md) - Retrieve detailed information on a single entity.
- [Searching entities](./searching-entities/searching-entities.md) - Retrieve a list of entities based on specific search criteria.
- [Filtering results](./searching-entities/filtering-search-results.md) - Filter search results based on specific criteria.
- [Sorting results](./searching-entities/sorting-and-paging.md#sorting) - Sort search results based on specific criteria.
- [Paging](./searching-entities/sorting-and-paging.md#paging) - Retrieve a subset of search results.
- [Making requests](./making-requests.md) - Learn how to make requests with different programming languages.