Authentication
The OpenAIRE APIs can be accessed over HTTPS both by authenticated and non authenticated requests. Currently, there is an adjustment period until October 2022, when the rate limit for both authenticated and non authenticated requests is up to 7200 requests per hour. After this period we plan to significantly lower the rate limit of non authenticated requests up to 60 requests per hour.
Please consider to make authenticated requests to achieve better rate limits. Check our Privacy Policy here.
OpenAIRE APIs Rate limits | |
---|---|
Not authenticated requests | up to 7200 requests per hour
soon to decrease - please see above |
Authenticated requests | up to 7200 request per hour |
Requests
To access the OpenAIRE APIs with better rate limits, send your access token using the Authorization header.
GET https://api.openaire.eu/{resourceServicePath} Authorization: Bearer {ACCESS_TOKEN}
To get an access token, we support personal access token creation and service registration.
Response Headers
x-ratelimit-limit | The maximum number of requests allowed for the client in one time window. |
x-ratelimit-used | The number of requests already made by the client in the current time window. |
The OpenAIRE APIs use a sliding time window of one hour.
Error Messages
404 - Not found
{ "error": "Not found", "description": "Invald request path." }
403 - Invalid Access Token
{ "error": "Token invalid", "description": "Authorization header value invalid." }
429 - Rate limit abuse for unauthenticated user
{ "error": "Too many requests", "description": "Request rate exceeded. Slow down." }
429 - Rate limit abuse
{ "error": "Too many requests", "description": "Request rate exceeded. Slow down." }