Filtering data sources

Filters narrow down the search results based on specific criteria. Each filter is provided as its own query parameter in the request URL:

param1=value1&param2=value2&...&paramN=valueN

note

By default, different filters are combined using the logical AND operator. To combine multiple values for a single filter, use the AND / OR / NOT operators inside the filter's value. See Using logical operators for full details.

Available parameters

Identity and name

Parameter	Description
search	Search in the content of the data source.
officialName	The official name of the data source.
englishName	The English name of the data source.
legalShortName	The legal name of the related organization in short form.
id	The OpenAIRE id of the data source.
pid	The persistent identifier of the data source.

Classification

Parameter	Description
subjects	List of subjects associated with the data source.
dataSourceTypeName	The data source type. See all values here.
contentTypes	Types of content in the data source, as defined by OpenDOAR.
eoscdatasourcetype	The EOSC data source type.
thematic	Whether the data source is thematic. (Boolean)
jurisdiction	The jurisdiction of the data source.
odLanguages	OpenDOAR languages supported by the data source.
compatibilityId	The compatibility id of the data source.
compatibilityName	The compatibility name of the data source.
country	The country of the data source.

Relations

Parameter	Description
relOrganizationId	Data sources connected to the organization (with OpenAIRE id).
relCommunityId	Data sources connected to the community (with OpenAIRE id).
relCollectedFromDatasourceId	Data sources collected from the data source (with OpenAIRE id).
collectedFromName	The name of the data source from which this data source was collected.

Using logical operators

The API supports the logical operators AND, OR, and NOT.

AND operator

/v3/datasources?search="open" AND "repository"

OR operator

/v3/datasources?dataSourceTypeName=("Journal" OR "Repository")

NOT operator

/v3/datasources?dataSourceTypeName=NOT "Journal"

note

When using AND, OR, or NOT, each value must be wrapped in double quotes. Bare (unquoted) values are only allowed when no operator is present.

See also the full list of examples.