openaire-api-http-doc/api.html

934 lines
60 KiB
HTML
Executable File

<!DOCTYPE html>
<html lang="en-gb">
<head>
<!--link href="http://demo.openaire.eu" rel="canonical" /-->
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<meta name="description" content="OpenAIRE API documentation, open access, research, scientific publication, European Commission, EC, FP7, ERC,
Horizon 2020, H2020, search, projects, publications, research data, datasets, HTTP, funders "/>
<link href="./assets/favicon.ico" rel="shortcut icon" />
<title>OpenAIRE API documentation - Selective access</title>
<script src="./assets/jquery.js"></script>
<script src="./assets/uikit.js"></script>
<script src="./assets/uikit-icon-max.js"></script>
<link rel="stylesheet" type="text/css" href="./assets/theme.css">
<link rel="stylesheet" type="text/css" href="./assets/custom.css">
<link rel="stylesheet" type="text/css" href="./assets/develop-custom.css">
</head>
<body class="" style="">
<div class="uk-offcanvas-content uk-height-viewport">
<div class="tm-header-mobile uk-hidden@m">
<div animation="uk-animation-slide-top" class="uk-navbar-container uk-sticky uk-navbar-transparent" cls-active="uk-active uk-navbar-sticky" cls-inactive="uk-navbar-transparent" uk-sticky="">
<nav class="uk-navbar-container uk-navbar" uk-navbar="">
<div class="uk-navbar-left">
<a class="uk-navbar-toggle" href="#tm-mobile" uk-toggle="">
<div uk-navbar-toggle-icon="" class="uk-navbar-toggle-icon uk-icon">
</div>
</a>
</div>
<div class="uk-navbar-center">
<a class="uk-navbar-item uk-logo" href="overview.html">
<img src="assets/OA DEVELOP_A.png" class="uk-responsive-height" alt="OpenAIRE"> </a>
</div>
</nav>
<div id="tm-mobile" uk-offcanvas="" mode="slide" overlay="" class="uk-offcanvas">
<div class="uk-offcanvas-bar">
<button class="uk-offcanvas-close uk-close uk-icon" type="button" uk-close="">
</button>
<div class="uk-child-width-1-1 uk-grid" uk-grid="">
<div>
<div class="uk-panel" id="module-0">
<ul class="uk-nav uk-nav-default">
<li class="uk-nav-header uk-parent" >
Dashboards
<ul class="uk-nav-sub">
<li><a href="https://explore.openaire.eu" target="_blank" class="uk-heading-bullet explore-heading-bullet">EXPLORE</a></li>
<li><a href="https://provide.openaire.eu" target="_blank" class="uk-heading-bullet provide-heading-bullet">PROVIDE</a></li>
<li><a href="https://connect.openaire.eu" target="_blank" class="uk-heading-bullet connect-heading-bullet">CONNECT</a></li>
<li><a href="https://monitor.openaire.eu" target="_blank" class="uk-heading-bullet monitor-heading-bullet">MONITOR</a></li>
</ul>
</li>
<li class="uk-nav-header uk-parent">
<a href="./overview.html"> Overview </a>
</li>
<li class="uk-nav-header uk-parent">
Bulk access
<ul class="uk-nav-sub">
<li><a routerLinkActive="uk-link" href="./graph-dumps.html" >OpenAIRE Research Graph Dumps</a></li>
<li><a routerLinkActive="uk-link" href="./oai-pmh.html" >OAI-PMH</a></li>
<li><a routerLinkActive="uk-link" href="./bulk-projects.html" >Bulk access to projects</a></li>
</ul>
</li>
<li class="uk-nav-header uk-parent uk-active">
<a href="./api.html">Selective access</a>
<ul class="uk-nav-sub">
<li><a href="./api.html#pubs" >Publications</a></li>
<li><a href="./api.html#datasets" >Research Data</a></li>
<li><a href="./api.html#software" >Software</a></li>
<li><a href="./api.html#other" >Other Research Products</a></li>
<li><a href="./api.html#projects" >Projects</a></li>
</ul>
</li>
</ul>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
<!--Mobile ENDS here -->
<div class="tm-toolbar custom-develop-toolbar uk-visible@m">
<div class="uk-container uk-flex uk-flex-middle uk-container-expand ">
<div class="uk-margin-auto-left">
<div class="uk-grid-medium uk-child-width-auto uk-flex-middle uk-grid uk-grid-stack" uk-grid="margin: uk-margin-small-top">
<div class="uk-first-column">
<div class="uk-panel inner" id="module-119">
<ul class="uk-subnav">
<li class="line"><a href="https://www.openaire.eu"><img class="uk-responsive-height" src="assets/Home_24white.svg" alt="home"/></a></li>
<li class="line"><a href="https://explore.openaire.eu" title="Search in OA. Link your research">Explore</a></li>
<li class="line"><a href="https://provide.openaire.eu" title="Content Provider Dashboard">Provide</a></li>
<li class="line"><a href="https://connect.openaire.eu" title="Research Community Dashboard">Connect</a></li>
<li class="line"><a href="https://monitor.openaire.eu" title="Monitoring Dashboard">Monitor</a></li>
<li class="line custom-develop-li "><a href="overview.html" title="APIs">Develop</a></li>
</ul>
</div>
</div>
</div>
</div>
</div>
</div>
<div class="tm-header uk-visible@m tm-header-transparent" uk-header="">
<div animation="uk-animation-slide-top" class="uk-navbar-container uk-sticky uk-navbar-transparent" cls-active="uk-active uk-navbar-sticky" cls-inactive="uk-navbar-transparent" top=".tm-header + [class*=&quot;uk-section&quot;]" uk-sticky="">
<div class="uk-navbar-container uk-navbar-transparent">
<div class="uk-container uk-container-expand">
<nav class="uk-navbar" uk-navbar="{&quot;align&quot;:&quot;left&quot;}">
<div class="uk-navbar-left">
<a href="overview.html" class="uk-navbar-item uk-logo">
<img src="assets/OA DEVELOP_B.png" class="uk-responsive-height" alt="OpenAIRE"></a>
</div>
<div class="uk-navbar-right">
<ul class="uk-navbar-nav">
<li class="uk-parent">
<a href="overview.html" class="" aria-expanded="false">Overview</a>
</li>
<li class="uk-parent">
<a href="#" class="" aria-expanded="false">Bulk access</a>
<div class="uk-navbar-dropdown uk-navbar-dropdown-bottom-left" style="left: 116px; top: 80px;">
<div class="uk-navbar-dropdown-grid uk-child-width-1-1 uk-grid uk-grid-stack" uk-grid="">
<div class="uk-first-column">
<ul class="uk-nav uk-navbar-dropdown-nav">
<li><a routerLinkActive="uk-link" href="./graph-dumps.html" >OpenAIRE Research Graph Dumps</a></li>
<li><a routerLinkActive="uk-link" href="./oai-pmh.html" >OAI-PMH</a></li>
<li><a routerLinkActive="uk-link" href="./bulk-projects.html" >Bulk access to projects</a></li>
</ul>
</div>
</div>
</div>
</li>
<li class="uk-parent uk-active">
<a href="#" class="" aria-expanded="false">Selective access</a>
<div class="uk-navbar-dropdown uk-navbar-dropdown-bottom-left" style="left: 228px; top: 80px;">
<div class="uk-navbar-dropdown-grid uk-child-width-1-1 uk-grid uk-grid-stack" uk-grid="">
<div class="uk-first-column">
<ul class="uk-nav uk-navbar-dropdown-nav">
<li><a href="./api.html#pubs" >Publications</a></li>
<li><a href="./api.html#datasets" >Research Data</a></li>
<li><a href="./api.html#software" >Software</a></li>
<li><a href="./api.html#other" >Other Research Products</a></li>
<li><a href="./api.html#projects" >Projects</a></li>
</ul>
</div>
</div>
</div>
</li>
</ul>
</div>
</nav>
</div>
</div>
</div>
</div>
<div class=" first_page_section uk-section-default uk-section uk-padding-remove-vertical">
<div class="first_page_banner_headline uk-grid-collapse uk-flex-middle uk-margin-remove-vertical uk-grid" uk-grid="">
</div>
</div>
<div class=" uk-section uk-margin-large-top tm-middle custom-main-content" id="tm-main">
<div class="uk-container">
<div class="uk-grid">
<div class="uk-width-1-3@s uk-width-1-4@m uk-width-1-4@l uk-visible@m" >
<ul class="uk-nav-default uk-nav-parent-icon" uk-nav="multiple: false" uk-sticky="offset: 100; media:@s" >
<li class="uk-parent uk-open">
<a href="#">HTTP API Documentation</a>
<ul class="uk-nav-sub">
<li><a href="#common" uk-scroll>Common Parameters</a></li>
<li><a href="#pubs" uk-scroll>Publications</a></li>
<li><a href="#datasets" uk-scroll>Research Data</a></li>
<li><a href="#software" uk-scroll>Software</a></li>
<li><a href="#other" uk-scroll>Other Research Products</a></li>
<li><a href="#projects" uk-scroll>Projects</a></li>
</ul>
</li>
</ul>
</div>
<div class="tm-main uk-width-expand uk-row-first uk-first-column">
<!--div class="uk-text-right" uk-sticky="offset:100; animation: uk-animation-slide-bottom; bottom: #bottom">
<a class="uk-totop" href="#" uk-scroll="" uk-totop="">
</a>
</div-->
<!--div class="uk-card uk-margin-remove uk-padding-remove uk-card-default uk-card-body" style="z-index: 980;" uk-sticky="offset:100; bottom: #bottom">
<a class="uk-totop" href="#" uk-scroll="" uk-totop="">
</a></div-->
<!-- <div class="uk-alert-danger uk-text-center" uk-alert>
<p>
OpenAIRE is about to release its new face with lots of news and services. <br>
During September, you may notice downtime in services, while some functionalities (e.g. user registration, validation, claiming) will be temporarily disabled.
We apologize for the inconvenience, please stay tuned! <br>
For further information please contact <a href="mailto:helpdesk@openaire.eu">helpdesk@openaire.eu</a>.
</p>
</div> -->
<div class="uk-alert-danger" uk-alert>
<h3>Contribute to improve the OpenAIRE Research Graph</h3>
<p>You can explore and test the beta release of the OpenAIRE Research Graph via the <a href="https://beta.explore.openaire.eu">OpenAIRE BETA Explore Portal</a> or via data dumps made available in <a href="https://zenodo.org/communities/openaire-research-graph">Zenodo</a>. </p>
<p>Help us making the graph ready for its 1st production release by providing your feedback by the end of December 2019.<br/>
Go to the <a href="https://trello.com/b/o1tEJ3rN/openaire-research-graph">OpenAIRE Research Graph Trello Board</a> to report content quality issues, including missing metadata records, wrong values, mistakes in the detection of duplicates and anything else that looks "weird" or wrong.
<p>Find the complete information about the OpenAIRE Research Graph, how to test it and contribute to improve it on <a href="https://www.openaire.eu/blogs/preview/1046-2027-the-openaire-research-graph">our blog</a>.</p>
</div>
<div class="uk-alert-danger" uk-alert>
<p>Openaire XML Schema changed on 2 October 2018. <a href="https://www.openaire.eu/openaire-xml-schema-change-announcement" target="_blank">Click here</a> for details</p>
</div>
<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 <a href="http://api.openaire.eu/#cha_oai_pmh" target="_blank">OAI-PMH</a>.<br>
</p>
<div>
<h4>TERMS OF USE AND SLA</h4>
<p><strong>OpenAIRE HTTP API</strong>: the APIs are free-to-use (no sign-up needed) by any third-party service. Note that:</p>
<ul>
<li>The HTTP API limits each query to 10,000 paged results; for unlimited access to the APIs please contact <a href="mailto:paolo.manghi@isti.cnr.it">the service administrators</a>.
</li>
<li>Since 2015 an <a href="https://zenodo.org/record/51077#.WsdCFdNubOR">RDF dump of the LOD is made available in Zenodo.org</a></li>
</ul>
<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>
<p><strong>Quality of Service</strong>: all API services are running in production 24/7 within the OpenAIRE infrastructure premises deployed at the <a href="http://icm.edu.pl/en/centre-of-technology/">data center</a> facilities of the <a href="http://icm.edu.pl/en/">Interdisciplinary Centre for Mathematical and Computational Modelling</a> (ICM).
</p>
<p><strong>APIs rate limits</strong>
<ul>
<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>
</ul>
</p>
</div>
<h2 id="common">Common Parameters</h2>
<p> Parameters included in this section can always be specified, regardless the type of <strong>entities</strong> (metadata about <strong>publications</strong>,
<strong>research data</strong>, <strong>software</strong>, <strong>other research products</strong>, or <strong>projects</strong>) you want to retrieve. <br>
To query for publications metadata: <strong>http://api.openaire.eu/search/publications</strong> <br>
To query for research data metadata: <strong>http://api.openaire.eu/search/datasets</strong> <br>
To query for software metadata: <strong>http://api.openaire.eu/search/software</strong> <br>
To query for other research products metadata: <strong>http://api.openaire.eu/search/other</strong> <br>
To query for projects metadata: <strong>http://api.openaire.eu/search/projects</strong> <br>
</p>
<table class="uk-table uk-table-striped uk-table-hover uk-table-small">
<thead>
<tr>
<th>Parameter</th>
<th>Option</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>page</td>
<td>integer</td>
<td>Page number of the search results.</td>
</tr>
<tr>
<td>size</td>
<td>integer</td>
<td>Number of results per page.</td>
</tr>
<tr>
<td>format</td>
<td>json | xml | csv | tsv</td>
<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 <a href="https://www.openaire.eu/schema/sygma/oaf_sygma_v2.1.xsd" target="_blank">here</a>.</td>
</tr>
<tr>
<td>sortBy</td>
<td><code>sortBy=field,[ascending|descending]</code></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>
</tr>
<tr>
<td>keywords</td>
<td>White-space separated list of keywords.</td>
<td>N/A</td>
</tr>
</tbody>
</table>
<h2 id="pubs">Publication specific parameters</h2>
<p>Endpoint: <strong>http://api.openaire.eu/search/publications</strong></p>
<table class="uk-table uk-table-striped uk-table-hover uk-table-small uk-table-justify">
<thead>
<tr>
<th>Parameter</th>
<th>Option</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>sortBy</td>
<td><code>sortBy=field,[ascending|descending]</code>; <strong>'field'</strong> is one of: <code>dateofcollection</code>, <code>resultstoragedate</code>, <code>resultstoragedate</code>, <code>resultembargoenddate</code>, <code>resultembargoendyear</code>, <code>resultdateofacceptance</code>, <code>resultacceptanceyear</code></td>
<td>The sorting order of the specified field.</td>
</tr>
<tr>
<td>doi</td>
<td>Comma separated list of DOIs. <br>
Alternatively, it is possible to repeat the parameter for each requested doi.
</td>
<td>Gets the publications with the given DOIs, if any.</td>
</tr>
<tr>
<td>openairePublicationID</td>
<td>Comma separated list of OpenAIRE identifiers. <br>
Alternatively, it is possible to repeat the parameter for each requested identifier.
</td>
<td>Gets the publication with the given openaire identifier, if any.</td>
</tr>
<tr>
<td>fromDateAccepted</td>
<td>Date formatted as <code>YYYY-MM-DD</code></td>
<td>Gets the publications whose date of acceptance is greater than or equal the given date.</td>
</tr>
<tr>
<td>toDateAccepted</td>
<td>Date formatted as <code>YYYY-MM-DD</code></td>
<td>Gets the publications whose date of acceptance is less than or equal the given date.</td>
</tr>
<tr>
<td>title</td>
<td>White-space separated list of keywords.</td>
<td>Gets the publications whose titles contain the given list of keywords.</td>
</tr>
<tr>
<td>author</td>
<td>White-space separated list of names and/or surnames.</td>
<td>Search for publications by authors.</td>
</tr>
<tr>
<td>openaireProviderID</td>
<td>Comma separated list of identifiers.</td>
<td>Search for publications by openaire data provider 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>
</tr>
<tr>
<td>openaireProjectID</td>
<td>Comma separated list of identifiers. <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>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>
</tr>
<tr>
<td>hasProject</td>
<td>true | false</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>
</tr>
<tr>
<td>country</td>
<td>2 letter country code</td>
<td>Search for publications associated to the country code</td>
</tr>
</tbody>
</table>
<h2 id="datasets">Research Data specific parameters</h2>
<p>Endpoint: <strong>http://api.openaire.eu/search/datasets</strong></p>
<table class="uk-table uk-table-striped uk-table-hover uk-table-small uk-table-justify">
<thead>
<tr>
<th>Parameter</th>
<th>Option</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>sortBy</td>
<td><code>sortBy=field,[ascending|descending]</code>; <strong>'field'</strong> is one of: <code>dateofcollection</code>, <code>resultstoragedate</code>, <code>resultstoragedate</code>, <code>resultembargoenddate</code>, <code>resultembargoendyear</code>, <code>resultdateofacceptance</code>, <code>resultacceptanceyear</code></td>
<td>The sorting order of the specified field.</td>
</tr>
<tr>
<td>doi</td>
<td>Comma separated list of DOIs. <br>
Alternatively, it is possible to repeat the parameter for each requested doi.
</td>
<td>Gets the datasets with the given DOIs, if any.</td>
</tr>
<tr>
<td>openaireDatasetID</td>
<td>Comma separated list of OpenAIRE identifiers. <br>
Alternatively, it is possible to repeat the parameter for each requested identifier.</td>
<td>Gets the dataset with the given openaire identifier, if any.</td>
</tr>
<tr>
<td>fromDateAccepted</td>
<td>Date formatted as <code>YYYY-MM-DD</code></td>
<td>Gets the datasets whose date of acceptance is greater than or equal the given date.</td>
</tr>
<tr>
<td>toDateAccepted</td>
<td>Date formatted as <code>YYYY-MM-DD</code></td>
<td>Gets the datasets whose date of acceptance is less than or equal the given date.</td>
</tr>
<tr>
<td>title</td>
<td>White-space separated list of keywords.</td>
<td>Gets the datasets whose titles contain the given list of keywords.</td>
</tr>
<tr>
<td>author</td>
<td>A white-space separated list of names and/or surnames</td>
<td>Search for datasets by authors.</td>
</tr>
<tr>
<td>openaireProviderID</td>
<td>Comma separated list of identifiers.</td>
<td>Search for datasets by openaire data provider 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>
</tr>
<tr>
<td>openaireProjectID</td>
<td>Comma separated list of identifiers. </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>
</tr>
<tr>
<td>projectID</td>
<td>...</td>
<td>The given grant identifier of the project.</td>
</tr>
<tr>
<td>hasProject</td>
<td>true | false</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>
</tr>
<tr>
<td>country</td>
<td>2 letter country code</td>
<td>Search for datasets associated to the country code</td>
</tr>
</tbody>
</table>
<h2 id="software">Software specific parameters</h2>
<p>Endpoint: <strong>http://api.openaire.eu/search/software</strong></p>
<table class="uk-table uk-table-striped uk-table-hover uk-table-small uk-table-justify">
<thead>
<tr>
<th>Parameter</th>
<th>Option</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>sortBy</td>
<td><code>sortBy=field,[ascending|descending]</code>; <strong>'field'</strong> is one of: <code>dateofcollection</code>, <code>resultstoragedate</code>, <code>resultstoragedate</code>, <code>resultembargoenddate</code>, <code>resultembargoendyear</code>, <code>resultdateofacceptance</code>, <code>resultacceptanceyear</code></td>
<td>The sorting order of the specified field.</td>
</tr>
<tr>
<td>doi</td>
<td>Comma separated list of DOIs. <br>
Alternatively, it is possible to repeat the parameter for each requested doi.
</td>
<td>Gets the software with the given DOIs, if any.</td>
</tr>
<tr>
<td>openaireSoftwareID</td>
<td>Comma separated list of OpenAIRE identifiers. <br>
Alternatively, it is possible to repeat the parameter for each requested identifier.</td>
<td>Gets the software with the given openaire identifier, if any.</td>
</tr>
<tr>
<td>fromDateAccepted</td>
<td>Date formatted as <code>YYYY-MM-DD</code></td>
<td>Gets the software whose date of acceptance is greater than or equal the given date.</td>
</tr>
<tr>
<td>toDateAccepted</td>
<td>Date formatted as <code>YYYY-MM-DD</code></td>
<td>Gets the software whose date of acceptance is less than or equal the given date.</td>
</tr>
<tr>
<td>title</td>
<td>White-space separated list of keywords.</td>
<td>Gets the software whose titles contain the given list of keywords.</td>
</tr>
<tr>
<td>author</td>
<td>A white-space separated list of names and/or surnames</td>
<td>Search for software by authors.</td>
</tr>
<tr>
<td>openaireProviderID</td>
<td>Comma separated list of identifiers.</td>
<td>Search for software by openaire data provider 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>
</tr>
<tr>
<td>openaireProjectID</td>
<td>Comma separated list of identifiers. </td>
<td>Search for software 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>
</tr>
<tr>
<td>projectID</td>
<td>...</td>
<td>The given grant identifier of the project.</td>
</tr>
<tr>
<td>hasProject</td>
<td>true | false</td>
<td>If hasProject is true gets the software that have a link to a project. If hasProject is false gets the software with no links to projects.</td>
</tr>
<tr>
<td>FP7ProjectID</td>
<td>...</td>
<td>Search for software 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 software. If OA is false gets the non Open Access software</td>
</tr>
<tr>
<td>country</td>
<td>2 letter country code</td>
<td>Search for software associated to the country code</td>
</tr>
</tbody>
</table>
<h2 id="other">Other Research Products specific parameters</h2>
<p>Endpoint: <strong>http://api.openaire.eu/search/other</strong></p>
<table class="uk-table uk-table-striped uk-table-hover uk-table-small uk-table-justify">
<thead>
<tr>
<th>Parameter</th>
<th>Option</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>sortBy</td>
<td><code>sortBy=field,[ascending|descending]</code>; <strong>'field'</strong> is one of: <code>dateofcollection</code>, <code>resultstoragedate</code>, <code>resultstoragedate</code>, <code>resultembargoenddate</code>, <code>resultembargoendyear</code>, <code>resultdateofacceptance</code>, <code>resultacceptanceyear</code></td>
<td>The sorting order of the specified field.</td>
</tr>
<tr>
<td>doi</td>
<td>Comma separated list of DOIs. <br>
Alternatively, it is possible to repeat the parameter for each requested doi.
</td>
<td>Gets the other research products with the given DOIs, if any.</td>
</tr>
<tr>
<td>openaireOtherID</td>
<td>Comma separated list of OpenAIRE identifiers. <br>
Alternatively, it is possible to repeat the parameter for each requested identifier.</td>
<td>Gets the other research products with the given openaire identifier, if any.</td>
</tr>
<tr>
<td>fromDateAccepted</td>
<td>Date formatted as <code>YYYY-MM-DD</code></td>
<td>Gets the other research products whose date of acceptance is greater than or equal the given date.</td>
</tr>
<tr>
<td>toDateAccepted</td>
<td>Date formatted as <code>YYYY-MM-DD</code></td>
<td>Gets the other research products whose date of acceptance is less than or equal the given date.</td>
</tr>
<tr>
<td>title</td>
<td>White-space separated list of keywords.</td>
<td>Gets the other research products whose titles contain the given list of keywords.</td>
</tr>
<tr>
<td>author</td>
<td>A white-space separated list of names and/or surnames</td>
<td>Search for other research products by authors.</td>
</tr>
<tr>
<td>openaireProviderID</td>
<td>Comma separated list of identifiers.</td>
<td>Search for other research products by openaire data provider 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>
</tr>
<tr>
<td>openaireProjectID</td>
<td>Comma separated list of identifiers. </td>
<td>Search for other research products 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>
</tr>
<tr>
<td>projectID</td>
<td>...</td>
<td>The given grant identifier of the project.</td>
</tr>
<tr>
<td>hasProject</td>
<td>true | false</td>
<td>If hasProject is true gets the other research products that have a link to a project. If hasProject is false gets the other research products with no links to projects.</td>
</tr>
<tr>
<td>FP7ProjectID</td>
<td>...</td>
<td>Search for other research products 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 other research products. If OA is false gets the non Open Access other research products</td>
</tr>
<tr>
<td>country</td>
<td>2 letter country code</td>
<td>Search for other research products associated to the country code</td>
</tr>
</tbody>
</table>
<h2 id="projects">Project specific parameters</h2>
<p>Endpoint: <strong>http://api.openaire.eu/search/projects</strong></p>
<table class="uk-table uk-table-striped uk-table-hover uk-table-small uk-table-justify">
<thead>
<tr>
<th>Parameter</th>
<th>Option</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>sortBy</td>
<td><code>sortBy=field,[ascending|descending]</code>; <strong>'field'</strong> is one of: <code>projectstartdate</code>, <code>projectstartyear</code>, <code>projectenddate</code>, <code>projectendyear</code>, <code> projectduration</code></td>
<td>The sorting order of the specified field.</td>
</tr>
<tr>
<td>grantID</td>
<td>Comma separated list of grant identifiers.</td>
<td>Gets the project with the given grant identifier, if any.</td>
</tr>
<tr>
<td>openairePublicationID</td>
<td>Comma separated list of OpenAIRE identifiers.</td>
<td>Gets the publication with the given openaire identifier, if any.</td>
</tr>
<tr>
<td>name</td>
<td>White-space separated list of keywords.</td>
<td>Gets the projects whose names contain the given list of keywords.</td>
</tr>
<tr>
<td>acronym</td>
<td>N/A</td>
<td>Gets the project with the given acronym, if any.</td>
</tr>
<tr>
<td>callID</td>
<td>N/A</td>
<td>Search for projects by call identifier.</td>
</tr>
<tr>
<td>startYear</td>
<td>Year formatted as <code>YYYY</code></td>
<td>Gets the projects that started in the given year.</td>
</tr>
<tr>
<td>endYear</td>
<td>Year formatted as <code>YYYY</code>.</td>
<td>Gets the projects that ended in the given year.</td>
</tr>
<tr>
<td>participantCountries</td>
<td>Comma separeted list of 2 letter country codes.</td>
<td>Search for projects by participant countries.</td>
</tr>
<tr>
<td>participantAcronyms</td>
<td>White space separeted list of acronyms of institutions.</td>
<td>Search for projects by participant institutions.</td>
</tr>
</tbody>
</table>
<!-- <div class="uk-card uk-margin-remove uk-padding-small uk-card-default uk-card-body uk-width-1-1@s uk-width-3-4@m uk-width-1-2@l" style="z-index: 100; bottom: 0px; position: fixed;" >
<a href="#" uk-scroll="" uk-totop="" class=" uk-align-right uk-totop uk-icon uk-margin-right">
</a>
</div> -->
</div>
</div>
</div>
</div>
<!-- FOOTER STARTS HERE-->
<div class="uk-section-primary uk-section uk-section-small uk-padding-remove-bottom">
<div class="uk-container uk-container-expand">
<div class="uk-container uk-container-expand uk-margin-small">
<div class="uk-grid-collapse uk-grid" uk-grid="">
<div id="footer#3" class="uk-width-expand@s uk-first-column">
<div class="uk-margin-small uk-margin-remove-top uk-text-left@s uk-text-center">
<img src="assets/Logo_Horizontal_white_small.png" data-width="126" data-height="30" class="el-image" alt="OpenAIRE">
</div>
<!--div id="footer#5" class="uk-margin uk-text-left@s uk-text-center">
<img src="assets/commission.jpg" sizes="(min-width: 50px) 50px" data-width="427" data-height="285" class="el-image" alt="European Commission">
</div-->
<div class="uk-margin"><img style="margin-right: 8px; float: left;" src="assets/commission.jpg" alt="flag black white low" width="50" height="33"><span style="font-size: 8pt; line-height: 0.7!important;">OpenAIRE-Advance receives funding from the European Union's Horizon 2020 Research and Innovation programme under Grant Agreement No. 777541.</span></div>
<div id="footer#6" class="newsletter uk-margin uk-margin-remove-bottom uk-text-left@s uk-text-center uk-panel">
<h5 class="el-title uk-margin uk-h5">
Newsletter
</h5>
<a target="_blank" href="https://www.openaire.eu/newsletter/view" class="el-link">
<span class="el-image uk-icon">
<svg width="20" height="20" viewBox="0 0 20 20" xmlns="http://www.w3.org/2000/svg">
<circle cx="3.12" cy="16.8" r="1.85"></circle>
<path fill="none" stroke="#000" stroke-width="1.1" d="M1.5,8.2 C1.78,8.18 2.06,8.16 2.35,8.16 C7.57,8.16 11.81,12.37 11.81,17.57 C11.81,17.89 11.79,18.19 11.76,18.5"></path>
<path fill="none" stroke="#000" stroke-width="1.1" d="M1.5,2.52 C1.78,2.51 2.06,2.5 2.35,2.5 C10.72,2.5 17.5,9.24 17.5,17.57 C17.5,17.89 17.49,18.19 17.47,18.5"></path>
</svg>
</span>
</a>
</div>
<div id="footer#7" class="newsletter uk-margin-small uk-margin-remove-top uk-text-left@s uk-text-center uk-panel">
<div class="acymailing_module" id="acymailing_module_formAcymailing60611">
<div class="acymailing_mootoolsbutton" id="acymailing_toggle_formAcymailing60611">
<p><a class="acymailing_togglemodule" id="acymailing_togglemodule_formAcymailing60611" target="_blank" href="https://www.openaire.eu/past-newsletters/listing">Subscribe</a></p>
</div>
</div>
</div>
<div class="uk-margin-small uk-margin-remove-top uk-text-left@s uk-text-center">
<div class="uk-child-width-auto uk-grid-small uk-flex-left@s uk-flex-center uk-grid" uk-grid="">
<div class="uk-first-column">
<a href="http://www.facebook.com/groups/openaire/" target="_blank" class="el-link uk-icon-button uk-icon">
<svg width="20" height="20" viewBox="0 0 20 20" xmlns="http://www.w3.org/2000/svg">
<path d="M11,10h2.6l0.4-3H11V5.3c0-0.9,0.2-1.5,1.5-1.5H14V1.1c-0.3,0-1-0.1-2.1-0.1C9.6,1,8,2.4,8,5v2H5.5v3H8v8h3V10z"></path>
</svg>
</a>
</div>
<div>
<a href="http://www.twitter.com/OpenAIRE_eu" target="_blank" class="el-link uk-icon-button uk-icon">
<svg width="20" height="20" viewBox="0 0 20 20" xmlns="http://www.w3.org/2000/svg">
<path d="M19,4.74 C18.339,5.029 17.626,5.229 16.881,5.32 C17.644,4.86 18.227,4.139 18.503,3.28 C17.79,3.7 17.001,4.009 16.159,4.17 C15.485,3.45 14.526,3 13.464,3 C11.423,3 9.771,4.66 9.771,6.7 C9.771,6.99 9.804,7.269 9.868,7.539 C6.795,7.38 4.076,5.919 2.254,3.679 C1.936,4.219 1.754,4.86 1.754,5.539 C1.754,6.82 2.405,7.95 3.397,8.61 C2.79,8.589 2.22,8.429 1.723,8.149 L1.723,8.189 C1.723,9.978 2.997,11.478 4.686,11.82 C4.376,11.899 4.049,11.939 3.713,11.939 C3.475,11.939 3.245,11.919 3.018,11.88 C3.49,13.349 4.852,14.419 6.469,14.449 C5.205,15.429 3.612,16.019 1.882,16.019 C1.583,16.019 1.29,16.009 1,15.969 C2.635,17.019 4.576,17.629 6.662,17.629 C13.454,17.629 17.17,12 17.17,7.129 C17.17,6.969 17.166,6.809 17.157,6.649 C17.879,6.129 18.504,5.478 19,4.74"></path>
</svg>
</a>
</div>
<div>
<a href="http://www.linkedin.com/groups/OpenAIRE-3893548" target="_blank" class="el-link uk-icon-button uk-icon">
<svg width="20" height="20" viewBox="0 0 20 20" xmlns="http://www.w3.org/2000/svg">
<path d="M5.77,17.89 L5.77,7.17 L2.21,7.17 L2.21,17.89 L5.77,17.89 L5.77,17.89 Z M3.99,5.71 C5.23,5.71 6.01,4.89 6.01,3.86 C5.99,2.8 5.24,2 4.02,2 C2.8,2 2,2.8 2,3.85 C2,4.88 2.77,5.7 3.97,5.7 L3.99,5.7 L3.99,5.71 L3.99,5.71 Z"></path>
<path d="M7.75,17.89 L11.31,17.89 L11.31,11.9 C11.31,11.58 11.33,11.26 11.43,11.03 C11.69,10.39 12.27,9.73 13.26,9.73 C14.55,9.73 15.06,10.71 15.06,12.15 L15.06,17.89 L18.62,17.89 L18.62,11.74 C18.62,8.45 16.86,6.92 14.52,6.92 C12.6,6.92 11.75,7.99 11.28,8.73 L11.3,8.73 L11.3,7.17 L7.75,7.17 C7.79,8.17 7.75,17.89 7.75,17.89 L7.75,17.89 L7.75,17.89 Z"></path>
</svg>
</a>
</div>
<div>
<a href="http://www.slideshare.net/OpenAIRE_eu" target="_blank" class="el-link uk-icon-button uk-icon">
<svg width="20" height="20" viewBox="0 0 20 20" xmlns="http://www.w3.org/2000/svg">
<line fill="none" stroke="#000" stroke-width="1.1" x1="13.4" y1="14" x2="6.3" y2="10.7"></line>
<line fill="none" stroke="#000" stroke-width="1.1" x1="13.5" y1="5.5" x2="6.5" y2="8.8"></line>
<circle fill="none" stroke="#000" stroke-width="1.1" cx="15.5" cy="4.6" r="2.3"></circle>
<circle fill="none" stroke="#000" stroke-width="1.1" cx="15.5" cy="14.8" r="2.3"></circle>
<circle fill="none" stroke="#000" stroke-width="1.1" cx="4.5" cy="9.8" r="2.3"></circle>
</svg>
</a>
</div>
<div>
<a href="https://www.youtube.com/channel/UChFYqizc-S6asNjQSoWuwjw" target="_blank" class="el-link uk-icon-button uk-icon">
<svg width="20" height="20" viewBox="0 0 20 20" xmlns="http://www.w3.org/2000/svg">
<path d="M15,4.1c1,0.1,2.3,0,3,0.8c0.8,0.8,0.9,2.1,0.9,3.1C19,9.2,19,10.9,19,12c-0.1,1.1,0,2.4-0.5,3.4c-0.5,1.1-1.4,1.5-2.5,1.6 c-1.2,0.1-8.6,0.1-11,0c-1.1-0.1-2.4-0.1-3.2-1c-0.7-0.8-0.7-2-0.8-3C1,11.8,1,10.1,1,8.9c0-1.1,0-2.4,0.5-3.4C2,4.5,3,4.3,4.1,4.2 C5.3,4.1,12.6,4,15,4.1z M8,7.5v6l5.5-3L8,7.5z"></path>
</svg>
</a>
</div>
</div>
</div>
</div>
<div id="footer#9" class="uk-width-expand@s">
<div id="footer#10" class="uk-width-medium uk-text-left@s uk-text-center uk-panel">
<h3 class="el-title uk-h6">Dashboards</h3>
<ul class="uk-nav uk-nav-default uk-nav-parent-icon uk-nav-accordion" uk-nav="">
<li><a href="https://explore.openaire.eu" target="_blank">Explore</a></li>
<li><a href="https://provide.openaire.eu" target="_blank">Provide</a></li>
<li><a href="https://connect.openaire.eu/" target="_blank">Connect</a></li>
<li><a href="https://monitor.openaire.eu" target="_blank">Monitor</a></li>
<li><a href="https://develop.openaire.eu" target="_blank">Develop</a></li>
</ul>
</div>
</div>
<div id="footer#11" class="uk-width-expand@s">
<div id="footer#12" class="uk-width-medium uk-text-left@s uk-text-center uk-panel">
<h3 class="el-title uk-h6">Support</h3>
<ul class="uk-nav uk-nav-default uk-nav-parent-icon uk-nav-accordion" uk-nav="">
<li><a href="https://www.openaire.eu/contact-noads">NOADs</a></li>
<li><a target="_blank" href="https://www.openaire.eu/guides">Guides</a></li>
<li><a target="_blank" href="https://www.openaire.eu/faqs">FAQs</a></li>
<li><a target="_blank" href="https://www.openaire.eu/frontpage/webinars">Webinars</a></li>
<li><a target="_blank" href="https://www.openaire.eu/support/helpdesk">Ask a question</a></li>
</ul>
</div>
</div>
<div id="footer#13" class="uk-width-expand@s">
<div id="footer#14" class="uk-width-medium uk-text-left@s uk-text-center uk-panel">
<h3 class="el-title uk-h6">Updates</h3>
<ul class="uk-nav uk-nav-default uk-nav-parent-icon uk-nav-accordion" uk-nav="">
<li><a target="_blank" href="https://www.openaire.eu/news/">News</a></li>
<li><a target="_blank" href="https://www.openaire.eu/events">Events</a></li>
<li><a target="_blank" href="https://www.openaire.eu/blogs/magazine">Blogs</a></li>
<li><a href="https://www.openaire.eu/newsletter/listing">Newsletters</a></li>
<li><a target="_blank" href="https://www.openaire.eu/documents">Documents</a></li>
</ul>
</div>
</div>
</div>
</div>
</div>
</div>
<div class="uk-section-primary uk-section uk-section-xsmall">
<div class="uk-container">
<div class="uk-grid-margin uk-grid uk-grid-stack" uk-grid="">
<div class="uk-width-expand@m">
</div>
</div>
</div>
</div>
<div class="uk-section-primary uk-section uk-section-xsmall">
<div class="uk-container uk-container-expand">
<div class="uk-grid-margin uk-grid" uk-grid="">
<div class="uk-width-small@m uk-first-column">
</div>
<div class="uk-width-expand@m">
<div id="footer#22" class=" uk-text-small uk-margin uk-margin-remove-bottom uk-text-center@m uk-text-center uk-text-lead">
<a href="http://creativecommons.org/licenses/by/4.0/" rel="license">
<img src="/images/Icons/cc.svg" uk-svg="" hidden="true">
<svg viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg" width="24" height="24" class=" uk-svg">
<title></title>
<g data-name="Creative Commons" id="Creative_Commons">
<circle cx="12" cy="12" r="11.5" style="fill:none;stroke:#ffffff;stroke-linecap:round;stroke-linejoin:round"></circle>
<path d="M10.87,10a3.5,3.5,0,1,0,0,4" style="fill:none;stroke:#ffffff;stroke-linecap:round;stroke-linejoin:round"></path>
<path d="M18.87,10a3.5,3.5,0,1,0,0,4" style="fill:none;stroke:#ffffff;stroke-linecap:round;stroke-linejoin:round"></path>
</g>
</svg>
&nbsp;<img src="/images/Icons/cc-by.svg" uk-svg="" hidden="true">
<svg viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg" width="24" height="24" class=" uk-svg">
<title></title>
<g id="Attribution">
<g data-name="<Group>" id="_Group_">
<circle cx="12" cy="5" data-name="<Path>" id="_Path_" r="1.5" style="fill:none;stroke:#ffffff;stroke-linecap:round;stroke-linejoin:round"></circle>
<path d="M12,8a5,5,0,0,0-3.07.71,1,1,0,0,0-.43.83V15H10v5.5h4V15h1.5V9.54a1,1,0,0,0-.43-.83A5,5,0,0,0,12,8Z" data-name="<Path>" id="_Path_2" style="fill:none;stroke:#ffffff;stroke-linecap:round;stroke-linejoin:round"></path>
</g>
<circle cx="12" cy="12" r="11.5" style="fill:none;stroke:#ffffff;stroke-linecap:round;stroke-linejoin:round"></circle>
</g>
</svg>
</a>
&nbsp;Unless otherwise indicated, all materials created by OpenAIRE are licenced under&nbsp;<a href="http://creativecommons.org/licenses/by/4.0/" rel="license">CC ATTRIBUTION 4.0 INTERNATIONAL LICENSE</a>.
</div>
</div>
<div class="uk-width-small@m">
<div class="uk-margin uk-margin-remove-top uk-margin-remove-bottom uk-text-right@m uk-text-center">
<a href="#" uk-totop="" uk-scroll="" class="uk-totop uk-icon">
</a>
</div>
</div>
</div>
</div>
</div>
<!-- FOOTER ENDS HERE-->
</div>
</body>
</html>