# Searching for research results ## 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`
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.
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.
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
| Accepted values:
`C1` for top 0.01% in terms of influence
`C2` for top 0.1% in terms of influence
`C3` for top 1% in terms of influence
`C4` for top 10% in terms of influence
`C5` for average/low in terms of influence

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
| Accepted values:
`C1` for top 0.01% in terms of popularity
`C2` for top 0.1% in terms of popularity
`C3` for top 1% in terms of popularity
`C4` for top 10% in terms of popularity
`C5` for average/low in terms of popularity

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
| Accepted values:
`C1` for top 0.01% in terms of impulse
`C2` for top 0.1% in terms of impulse
`C3` for top 1% in terms of impulse
`C4` for top 10% in terms of impulse
`C5` for average/low in terms of impulse

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
| Accepted values:
`C1` for top 0.01% in terms of citation count
`C2` for top 0.1% in terms of citation count
`C3` for top 1% in terms of citation count
`C4` for top 10% in terms of citation count
`C5` for average/low in terms of citation count

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.
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.
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.
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]`.
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.
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.
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:
true \| false | Specify if the publications are peerReviewed or not. | | diamondJournal | Accepted values:
true \| false | Specify if the publications are published in a diamond journal or not. | | publiclyFunded | Accepted values:
true \| false | Specify if the publications are publicly funded or not. | | green | Accepted values:
true \| false | Specify if the publications are green open access or not. | | openAccessColor | Accepted values:
`gold`\| `bronze`\| `hybrid`
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.
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.
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.
Alternatively, it is possible to repeat the parameter for each requested identifier. | Gets the other research products with the given openaire identifier, if any. |