# Searching for research products

## Endpoints 

For research products: https://api.openaire.eu/search/researchProducts  

By specific type:
* publications: https://api.openaire.eu/search/publications 
* research data: https://api.openaire.eu/search/datasets 
* research software: https://api.openaire.eu/search/software 
* other research products: https://api.openaire.eu/search/other 


## General parameters

Endpoint: https://api.openaire.eu/search/researchProducts

| Parameter | Option | Description |
| --- | --- | --- |
| page | integer | Page number of the search results. |
| size | integer | Number of results per page. |
| format | json \| xml \| csv \| tsv | The format of the response. The default is xml. |
| model | openaire \| sygma | 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 [here](https://www.openaire.eu/schema/sygma/oaf_sygma_v2.1.xsd). |
| sortBy | `sortBy=field,[ascending\|descending]`; **'field'** is one of: `dateofcollection`,`resultstoragedate`,`resultstoragedate`, `resultembargoenddate`,`resultembargoendyear`,`resultdateofacceptance`, `resultacceptanceyear`,`influence`,`popularity`, `citationCount`,`impulse`  <br/>Multiple sorting is supported by repeating the `sortBy` parameter. | The sorting order of the specified field. |
| hasECFunding | true \| false | 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. |
| hasWTFunding | true \| false | If hasWTFunding is true gets the entities funded by Wellcome Trust. The results are the same as those obtained with `funder=wt`. If hasWTFunding is false gets the entities related to projects not funded by Wellcome Trust. |
| funder | WT \| EC \| ARC \| ANDS \| NSF \| FCT \| NHMRC | Search for entities by funder. |
| fundingStream | ... | Search for entities by funding stream. |
| FP7scientificArea | ... | Search for FP7 entities by scientific area. |
| keywords | White-space separated list of keywords. | N/A |
| doi | Comma separated list of DOIs.  <br/>Alternatively, it is possible to repeat the parameter for each requested doi. | Gets the research products with the given DOIs, if any. |
| orcid | Comma separated list of ORCID iDs of authors.  <br/>Alternatively, it is possible to repeat the parameter for each author ORCID iD. | Gets the research products linked to the given ORCID iD of an author, if any. |
| fromDateAccepted | Date formatted as `YYYY-MM-DD` | Gets the research products whose date of acceptance is greater than or equal the given date. |
| toDateAccepted | Date formatted as `YYYY-MM-DD` | Gets the research products whose date of acceptance is less than or equal the given date. |
| title | White-space separated list of keywords. | Gets the research products whose titles contain the given list of keywords. |
| author | White-space separated list of names and/or surnames. | Search for research products by authors. |
| OA  | true \| false | If OA is true gets Open Access research products. If OA is false gets the non Open Access research products |
| projectID | The given grant identifier of the project | Search for research products of the project with the specified projectID |
| country | 2 letter country code | Search for research products associated to the country code |
| influence  <br/> | Accepted values:  <br/>`C1` for top 0.01% in terms of influence  <br/>`C2` for top 0.1% in terms of influence  <br/>`C3` for top 1% in terms of influence  <br/>`C4` for top 10% in terms of influence  <br/>`C5` for average/low in terms of influence  <br/>  <br/>Comma separated list of values or repeat of the parameter for each value will form a query with OR semantics, eg. `?influence=C1&influence=C2` | Search for research products based on their influence. |
| popularity  <br/> | Accepted values:  <br/>`C1` for top 0.01% in terms of popularity  <br/>`C2` for top 0.1% in terms of popularity  <br/>`C3` for top 1% in terms of popularity  <br/>`C4` for top 10% in terms of popularity  <br/>`C5` for average/low in terms of popularity  <br/>  <br/>Comma separated list of values or repeat of the parameter for each value will form a query with OR semantics, eg. `?popularity=C1&popularity=C2` | Search for research products based on their popularity. |
| impulse  <br/> | Accepted values:  <br/>`C1` for top 0.01% in terms of impulse  <br/>`C2` for top 0.1% in terms of impulse  <br/>`C3` for top 1% in terms of impulse  <br/>`C4` for top 10% in terms of impulse  <br/>`C5` for average/low in terms of impulse  <br/>  <br/>Comma separated list of values or repeat of the parameter for each value will form a query with OR semantics, eg. `?impulse=C1&impulse=C2` | Search for research products based on their impulse. |
| citationCount  <br/> | Accepted values:  <br/>`C1` for top 0.01% in terms of citation count  <br/>`C2` for top 0.1% in terms of citation count  <br/>`C3` for top 1% in terms of citation count  <br/>`C4` for top 10% in terms of citation count  <br/>`C5` for average/low in terms of citation count  <br/>  <br/>Comma separated list of values or repeat of the parameter for each value will form a query with OR semantics, eg. `?citationCount=C1&citationCount=C2` | Search for research products based on their number of citations. |
| openaireProviderID | Comma separated list of identifiers. | Search for 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. |
| openaireProjectID | 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. | Search for research products 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. |
| hasProject | true \| false | If hasProject is true gets the research products that have a link to a project. If hasProject is false gets the publications with no links to projects. |
| FP7ProjectID | ... | Search for research products associated to a FP7 project with the given grant number. It is equivalent to a query by `funder=FP7&projectID={grantID}` |


## Parameters for publications

Endpoint: https://api.openaire.eu/search/publications

You can use all the [general research products parameters](#general-parameters) as well as those in the following table.

| Parameter | Option | Description |
| --- | --- | --- |
| instancetype | Comma separated list of publication types. Check [here](http://api.openaire.eu/vocabularies/dnet:publication_resource) to see the possible values | Gets the publication of the given type, if any. |
| originalId | Comma separated list of original identifiers as we get them from the data source.  <br/>Alternatively, it is possible to repeat the parameter for each requested identifier. | Gets the publication with the given openaire identifier, if any. |
| sdg | The number of the Sustainable Development Goals `[1-17]`.  <br/>Check [here](https://sdgs.un.org/goals) to see the Sustainable Developemnt Goals. | Gets the publications that are classified with the respective Sustainable Development Goal number. |
| fos | The Field of Science classification value.  <br/>Check [here](/resources/athenarc_fos_hierarchy.json) to see the Field of Science classification values | Gets the publications that are classified with the respective Field of Science classification value. |
| openairePublicationID | Comma separated list of OpenAIRE identifiers.  <br/>Alternatively, it is possible to repeat the parameter for each requested identifier. | Gets the publication with the given openaire identifier, if any. |
| peerReviewed  | Accepted values:  <br/>true \| false | Specify if the publications are peerReviewed or not. |
| diamondJournal  | Accepted values:  <br/>true \| false | Specify if the publications are published in a diamond journal or not. |
| publiclyFunded  | Accepted values:  <br/>true \| false | Specify if the publications are publicly funded or not. |
| green  | Accepted values:  <br/>true \| false | Specify if the publications are green open access or not. |
| openAccessColor  | Accepted values:  <br/>`gold`\| `bronze`\| `hybrid`  <br/>Comma separated list of values or repeat of the parameter for each value will form a query with OR semantics, eg. `?openAccessColor=gold&openAccessColor=hybrid` | Specify the open access color of a publication. |

## Parameters for research data

Endpoint: https://api.openaire.eu/search/datasets

You can use all the [general research products parameters](#general-parameters) as well as those in the following table.

| Parameter | Option | Description |
| --- | --- | --- |
| openaireDatasetID | Comma separated list of OpenAIRE identifiers.  <br/>Alternatively, it is possible to repeat the parameter for each requested identifier. | Gets the research data with the given openaire identifier, if any. |

## Parameters for research software

Endpoint: https://api.openaire.eu/search/software

You can use all the [general research products parameters](#general-parameters) as well as those in the following table.

| Parameter | Option | Description |
| --- | --- | --- |
| openaireSoftwareID | Comma separated list of OpenAIRE identifiers.  <br/>Alternatively, it is possible to repeat the parameter for each requested identifier. | Gets the research software with the given openaire identifier, if any. |

## Parameters for other research products 

Endpoint: https://api.openaire.eu/search/other

You can use all the [general research products parameters](#general-parameters) as well as those in the following table.

| Parameter | Option | Description |
| --- | --- | --- |
| openaireOtherID | Comma separated list of OpenAIRE identifiers.  <br/>Alternatively, it is possible to repeat the parameter for each requested identifier. | Gets the other research products with the given openaire identifier, if any. |

