OpenAIRE team is about to release a major update in services & portals. During September, you may notice downtime in services, while some functionalities (e.g. user registration, validation, claiming) will be temporarily disabled.
We are sorry for the inconvenience, please stay tuned!
<p>Openaire XML Schema has been changed! Please <ahref="https://www.openaire.eu/openaire-xml-schema-change-announcement"target="_blank">click here</a> to learn more!</p>
The OpenAIRE HTTP API allows developers to access the metadata information space of OpenAIRE by performing queries over publications, datasets, and projects.
The API is intended for metadata discovery and exploration only, that is it does not give direct access to publication files and it does not provide access to
the whole information space: the number of total results returned by one query is limited to 10,000. For accessing the whole information space, developers are
encouraged to use the <ahref="http://api.openaire.eu/#cha_oai_pmh"target="_blank">OAI-PMH</a>.<br>
<li>The HTTP API limits each query to 10,000 paged results; for unlimited access to the APIs please contact <ahref="mailto:paolo.manghi@isti.cnr.it">the service administrators</a>.
</li>
<li>Since 2015 an <ahref="https://zenodo.org/record/51077#.WsdCFdNubOR">RDF dump of the LOD is made available in Zenodo.org</a></li>
<p><strong> Metadata license is CC-BY</strong>: the metadata records retuned by the service can be freely re-used by commercial and non-commercial partners under CC-BY license, hence as long as OpenAIRE is acknowledged as content provider.
<p><strong>Quality of Service</strong>: all API services are running in production 24/7 within the OpenAIRE infrastructure premises deployed at the <ahref="http://icm.edu.pl/en/centre-of-technology/">data center</a> facilities of the <ahref="http://icm.edu.pl/en/">Interdisciplinary Centre for Mathematical and Computational Modelling</a> (ICM).
<li>no more than 30 concurrent connections from single IP to any APIs</li>
<li>no more than 67 concurrent requests in total</li>
<li>no more then 37 concurrent request in total (max 30 per single IP) to the HTTP API for selective access</li>
<li>no more than 15 requests/second to the HTTP API for selective access (in total, not per IP. If this limit is reached, requests will be delayed).</li>
<p> Parameters included in this section can always be specified, regardless the type of <strong>entities</strong> (metadata about <strong>publications</strong>,
<td>The format of the response. The default is xml.</td>
</tr>
<tr>
<td>model</td>
<td>openaire | sygma</td>
<td>The data model of the response. Default is openaire. Model sygma is a simplified version of the openaire model. For sygma, only the xml format is available. The relative XML schema is available <ahref="https://www.openaire.eu/schema/sygma/oaf_sygma_v2.1.xsd"target="_blank">here</a>.</td>
<td>The sorting order of the specified field. For the list of sortable fields, please refer to the documentation relative to the specific type of entity you are querying for.</td>
</tr>
<tr>
<td>hasECFunding</td>
<td>true | false</td>
<td>If hasECFunding is true gets the entities funded by the EC. If hasECFunding is false gets the entities related to projects not funded by the EC.</td>
</tr>
<tr>
<td>hasWTFunding</td>
<td>true | false</td>
<td>If hasWTFunding is true gets the entities funded by Wellcome Trust. The results are the same as those obtained with <code>funder=wt</code>. If hasWTFunding is false gets the entities related to projects not funded by Wellcome Trust.</td>
</tr>
<tr>
<td>funder</td>
<td>WT | EC | ARC | ANDS | NSF | FCT | NHMRC</td>
<td>Search for entities by funder.</td>
</tr>
<tr>
<td>fundingStream</td>
<td>...</td>
<td>Search for entities by funding stream.</td>
</tr>
<tr>
<td>FP7scientificArea</td>
<td>...</td>
<td>Search for FP7 entities by scientific area.</td>
Alternatively, it is possible to repeat the parameter for each provider id. In both cases, provider identifiers will form a query with OR semantics.</td>
Alternatively, it is possible to repeat the parameter for each provider id. In both cases, provider identifiers will form a query with OR semantics.</td>
<td>Search for publications by openaire project identifier. Alternatively, it is possible to repeat the parameter for each provider id. In both cases, provider identifiers will form a query with OR semantics.</td>
<td>If hasProject is true gets the publications that have a link to a project. If hasProject is false gets the publications with no links to projects.</td>
</tr>
<tr>
<td>projectID</td>
<td>...</td>
<td>The given grant identifier of the project.</td>
</tr>
<tr>
<td>FP7ProjectID</td>
<td>...</td>
<td>Search for publications associated to a FP7 project with the given grant number. It is equivalent to a query by <code>funder=FP7&projectID=grantID</code></td>
</tr>
<tr>
<td>OA</td>
<td>true | false</td>
<td>If OA is true gets Open Access publications. If OA is false gets the non Open Access publications</td>
Alternatively, it is possible to repeat the parameter for each provider id. In both cases, provider identifiers will form a query with OR semantics.</td>
<td>Search for datasets by openaire project identifier. <br>
Alternatively, it is possible to repeat the parameter for each provider id. In both cases, provider identifiers will form a query with OR semantics.</td>
<td>If hasProject is true gets the datasets that have a link to a project. If hasProject is false gets the datasets with no links to projects.</td>
</tr>
<tr>
<td>FP7ProjectID</td>
<td>...</td>
<td>Search for datasets associated to a FP7 project with the given grant number. It is equivalent to a query by <code>funder=FP7&projectID=grantID</code></td>
</tr>
<tr>
<td>OA</td>
<td>true | false</td>
<td>If OA is true gets Open Access datasets. If OA is false gets the non Open Access datasets</td>
<div><ahref="http://creativecommons.org/licenses/by/4.0/"rel="license"><imgalt="Creative"src="./assets/80x15.png"style="height: auto; max-width: 100%; vertical-align: middle;"></a> UNLESS OTHERWISE INDICATED, ALL MATERIALS CREATED BY THE OPENAIRE CONSORTIUM ARE LICENSED UNDER A <ahref="http://creativecommons.org/licenses/by/4.0/"rel="license">CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE</a>.</div>
<div>OPENAIRE IS POWERED BY <ahref="http://www.d-net.research-infrastructures.eu/">D-NET</a>.</div>