Filter syntax
The filter parameter uses a compact field:value grammar that replaces the individual query parameters of previous API versions.
Operators
| Operator | Meaning | Example |
|---|---|---|
, | AND across fields | type:Institutional Repository,country:GR |
| | OR within a field | country:GR|IT |
! | Negation | type:!Journal |
Filters are combined with AND (comma). Within a single field, use pipe (|) for OR. These cannot be mixed — each field entry is either a single value, a negation, or an OR-list.
Filter fields
Identity
| Field | Type | OR | NOT | Facetable | Example |
|---|---|---|---|---|---|
id | string | ✓ | ✓ | — | id:eosc________::4ea7143d33465aa83b3f3e00963c16b7 |
pid | string | ✓ | ✓ | — | pid:re3data_____::r3d100010468 |
Text search sub-filters
These fields allow targeted text searches within specific parts of the data source. They are used inside the filter parameter, unlike the top-level search parameter which searches across all default fields.
| Field | Description | Example |
|---|---|---|
official_name.search | Search within the official name | official_name.search:zenodo |
english_name.search | Search within the English name | english_name.search:zenodo |
default.search | Search all default fields (same as top-level search) | default.search:repository |
Classification
| Field | Type | OR | NOT | Facetable | Example |
|---|---|---|---|---|---|
type | string | ✓ | ✓ | ✓ | type:Repository — see the dnet:datasource_typologies vocabulary |
subjects | string | ✓ | ✓ | ✓ | subjects:Multidisciplinary |
content_types | string | ✓ | ✓ | ✓ | content_types:Journal articles |
eosc_datasource_type | string | ✓ | ✓ | ✓ | eosc_datasource_type:Repository |
jurisdiction | string | ✓ | ✓ | ✓ | jurisdiction:Institutional |
thematic | boolean | — | ✓ | ✓ | thematic:true |
od_languages | string | ✓ | ✓ | ✓ | od_languages:English |
Country
| Field | Type | OR | NOT | Facetable | Example |
|---|---|---|---|---|---|
country | string | ✓ | ✓ | ✓ | country:GR|IT |
continent | enum | ✓ | ✓ | — | continent:europe |
is_global_south | boolean | — | ✓ | — | is_global_south:true |
continent accepts africa, antarctica, asia, europe, north_america, oceania or south_america; an unknown name is rejected with a 400 listing the valid ones. Both fields expand server-side into the matching ISO country codes — drawn from the UN Statistics Division M49 classification and the UN Finance Center for South-South Cooperation respectively — so they are not facetable.
A single field accepts at most 50 pipe-separated values; beyond that the request is rejected with a 400 naming the field. Server-side expansion such as continent:europe does not count toward that limit.
Compatibility
| Field | Type | OR | NOT | Facetable | Example |
|---|---|---|---|---|---|
compatibility.id | string | ✓ | ✓ | ✓ | compatibility.id:openaire4.0 |
compatibility.name | string | ✓ | ✓ | ✓ | compatibility.name:OpenAIRE PubRepos v4.0 |
Relations
| Field | Type | OR | NOT | Facetable | Example |
|---|---|---|---|---|---|
organizations.id | string | ✓ | ✓ | ✓ | OpenAIRE organization id |
communities.id | string | ✓ | ✓ | ✓ | communities.id:neuroscience |
collected_from.id | string | ✓ | ✓ | ✓ | collected_from.id:openaire____::47ce9e9f4fad46e732cff06419ecaabb |
collected_from.name | string | ✓ | ✓ | — | collected_from.name:OpenDOAR |
Combined examples
Greek repositories:
/v4/datasources?filter=type:Institutional Repository,country:GRThematic, OpenAIRE PubRepos v4.0-compatible data sources:
/v4/datasources?filter=thematic:true,compatibility.name:OpenAIRE PubRepos v4.0Everything except journals:
/v4/datasources?filter=type:!Journal