Examples
A collection of ready-to-use API calls for projects. All URLs point to the beta environment:
https://api-beta.openaire.eu/graph/v4/projects
Top-level parameters
Search
Sort
/v4/projects?filter=funder_short_name:EC&sort=start_date:desc
Offset pagination
/v4/projects?filter=funder_short_name:EC&page=2&page_size=25
Cursor pagination
/v4/projects?filter=funder_short_name:EC&page_size=100&cursor=*
Select (sparse fieldsets)
/v4/projects?filter=funder_short_name:EC&select=id,code,acronym,title
Facets
/v4/projects?search=climate&facets=funder_short_name,start_year&page_size=5
Group by
/v4/projects?group_by=funder_short_name
Filter — Identity
By OpenAIRE id
/v4/projects?filter=id:100007490___::1e5e62235d094afd01cd56e65112fc63
By grant code
/v4/projects?filter=code:101000360
By acronym
/v4/projects?filter=acronym:OpenAIRE
By call identifier
/v4/projects?filter=call_identifier:H2020-INFRAEOSC-2018-2
Filter — Text search
Title search
/v4/projects?filter=title.search:open science
Keywords search
/v4/projects?filter=keywords.search:infrastructure
Filter — Funding
By funder short name
/v4/projects?filter=funder_short_name:EC
By funder short name (OR)
/v4/projects?filter=funder_short_name:EC|NIH|NSF
By funder name
/v4/projects?filter=funder:European Commission
By funding stream
/v4/projects?filter=funding_stream_id:H2020
By funding level 0
/v4/projects?filter=funding_level_0_id:ec__________::EC::FP7
By funding level 1
/v4/projects?filter=funding_level_1_id:ec__________::EC::FP7::SP1
By funding level 2
/v4/projects?filter=funding_level_2_id:ec__________::EC::FP7::SP1::HEALTH
Filter — Dates and years
Start year (exact)
/v4/projects?filter=start_year:2020
Start year (greater than)
/v4/projects?filter=start_year:>2022
End year (less than)
/v4/projects?filter=end_year:<2026
Active in a given year
/v4/projects?filter=active_year:2022
Start date range
/v4/projects?filter=from_start_date:2020-01-01,to_start_date:2020-12-31
End date range
/v4/projects?filter=from_end_date:2024-01-01,to_end_date:2024-12-31
Filter — Country and OA mandate
By country
/v4/projects?filter=country:GR
With OA mandate for publications
/v4/projects?filter=oa_mandate_publications:true
Filter — Relations
By related organization
/v4/projects?filter=organizations.id:anr_________::1bb745121fc1c70e1e5b3fbe20a06bf8
By related organization name
/v4/projects?filter=organizations.name:University of Athens
By related organization country (OR)
/v4/projects?filter=organizations.country:US|GR
By community
/v4/projects?filter=communities.id:egi
By collected-from data source
/v4/projects?filter=collected_from.id:openaire____::corda
Combined examples
EC H2020 projects active in 2022
/v4/projects?filter=funder_short_name:EC,funding_stream_id:H2020,active_year:2022
Greek projects starting 2020+, OA mandate
/v4/projects?filter=country:GR,start_year:>2019,oa_mandate_publications:true
Projects per funder, facets only
/v4/projects?filter=active_year:2024&group_by=funder_short_name