Skip to main content
Version: Next

Searching for research results

Endpoints

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

By specific type:

General parameters

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

ParameterOptionDescription
pageintegerPage number of the search results.
sizeintegerNumber of results per page.
formatjson | xml | csv | tsvThe format of the response. The default is xml.
modelopenaire | sygmaThe 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.
sortBysortBy=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.
hasECFundingtrue | falseIf 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.
hasWTFundingtrue | falseIf 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.
funderWT | EC | ARC | ANDS | NSF | FCT | NHMRCSearch for entities by funder.
fundingStream...Search for entities by funding stream.
FP7scientificArea...Search for FP7 entities by scientific area.
keywordsWhite-space separated list of keywords.N/A
doiComma 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.
orcidComma 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.
fromDateAcceptedDate formatted as YYYY-MM-DDGets the research products whose date of acceptance is greater than or equal the given date.
toDateAcceptedDate formatted as YYYY-MM-DDGets the research products whose date of acceptance is less than or equal the given date.
titleWhite-space separated list of keywords.Gets the research products whose titles contain the given list of keywords.
authorWhite-space separated list of names and/or surnames.Search for research products by authors.
OAtrue | falseIf OA is true gets Open Access research products. If OA is false gets the non Open Access research products
projectIDThe given grant identifier of the projectSearch for research products of the project with the specified projectID
country2 letter country codeSearch 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.
openaireProviderIDComma 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.
openaireProjectIDComma 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.
hasProjecttrue | falseIf 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 as well as those in the following table.

ParameterOptionDescription
instancetypeComma separated list of publication types. Check here to see the possible valuesGets the publication of the given type, if any.
originalIdComma 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.
sdgThe number of the Sustainable Development Goals [1-17].
Check here to see the Sustainable Developemnt Goals.
Gets the publications that are classified with the respective Sustainable Development Goal number.
fosThe Field of Science classification value.
Check here to see the Field of Science classification values
Gets the publications that are classified with the respective Field of Science classification value.
openairePublicationIDComma 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.
peerReviewedAccepted values:
true | false
Specify if the publications are peerReviewed or not.
diamondJournalAccepted values:
true | false
Specify if the publications are published in a diamond journal or not.
publiclyFundedAccepted values:
true | false
Specify if the publications are publicly funded or not.
greenAccepted values:
true | false
Specify if the publications are green open access or not.
openAccessColorAccepted 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 as well as those in the following table.

ParameterOptionDescription
openaireDatasetIDComma 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 as well as those in the following table.

ParameterOptionDescription
openaireSoftwareIDComma 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 as well as those in the following table.

ParameterOptionDescription
openaireOtherIDComma 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.