Examples
A collection of ready-to-use API calls covering every parameter and filter field. All URLs point to the beta environment:
https://api-beta.openaire.eu/graph/v4/research-products
You can also browse all examples in the interactive test page.
Top-level parameters
Search
/v4/research-products?search=openaire
Sort
/v4/research-products?filter=type:publication&sort=citation_count:desc
Select (sparse fieldsets)
/v4/research-products?filter=type:publication&select=id,mainTitle,authors.fullName
Facets
/v4/research-products?search=covid&facets=type,best_oa.rights,language&page_size=5
Group by
/v4/research-products?group_by=type
Offset pagination
/v4/research-products?filter=type:publication&page=3&page_size=25
Cursor pagination
/v4/research-products?filter=type:publication&page_size=100&cursor=*
Filter — Identity
By OpenAIRE ID
/v4/research-products?filter=id:doi_dedup___::a55b42c0d32a4a24cf99e621623d110e
By DOI
/v4/research-products?filter=ids.doi:10.1038/s41586-023-06221-2
By PMID
/v4/research-products?filter=ids.pmid:37468626
By PMC ID
/v4/research-products?filter=ids.pmcid:PMC10356604
By arXiv ID
/v4/research-products?filter=ids.arxiv:2301.00001
By Handle
/v4/research-products?filter=ids.handle:1234/56789
By original ID
/v4/research-products?filter=ids.original:oai:repo:12345
By any PID
/v4/research-products?filter=ids.pid:10.1109/robot.2010.5509305
Filter — Classification
By type
/v4/research-products?filter=type:publication
By type (OR)
/v4/research-products?filter=type:publication|dataset
By type (NOT)
/v4/research-products?filter=type:!other
By instance type
/v4/research-products?filter=instance_type:Article
By subject
/v4/research-products?filter=subjects:climate
By SDG
/v4/research-products?filter=sdg:13
By Field of Science
/v4/research-products?filter=fos:0102 Computer and information sciences
Filter — Dates
Publication date (from)
/v4/research-products?filter=from_publication_date:2024-01-01
Publication date (range)
/v4/research-products?filter=from_publication_date:2024-01-01,to_publication_date:2024-12-31
Publication year (from)
/v4/research-products?filter=from_publication_year:2020
Publication year (range)
/v4/research-products?filter=from_publication_year:2021,to_publication_year:2025
Date of collection (after)
/v4/research-products?filter=date_of_collection:>2024-01-01
Filter — Text search sub-filters
Title search
/v4/research-products?filter=title.search:neural network
Abstract search
/v4/research-products?filter=abstract.search:machine learning
Default search (title + abstract + subject)
/v4/research-products?filter=default.search:biodiversity
Filter — Authors
By author name
/v4/research-products?filter=authorships.author.fullname:Paolo Manghi
By author ORCID
/v4/research-products?filter=authorships.author.orcid:0000-0002-1825-0097
By institution ROR
/v4/research-products?filter=authorships.institutions.ror:https://ror.org/052gg0110
By country
/v4/research-products?filter=authorships.countries:GR
By country (OR)
/v4/research-products?filter=authorships.countries:GR|IT|ES
Filter — Access and peer review
By access rights
/v4/research-products?filter=best_oa.rights:Open Access
By access rights (OR)
/v4/research-products?filter=best_oa.rights:Open Access|Open Source
By access rights (NOT)
/v4/research-products?filter=best_oa.rights:!Closed Access
By OA color
/v4/research-products?filter=oa_color:gold
By OA color (OR)
/v4/research-products?filter=oa_color:gold|hybrid
Green Open Access
/v4/research-products?filter=is_green:true
Peer reviewed
/v4/research-products?filter=is_peer_reviewed:true
Diamond journal
/v4/research-products?filter=is_in_diamond_journal:true
Publicly funded
/v4/research-products?filter=is_publicly_funded:true
Filter — Impact
By influence class
/v4/research-products?filter=impact.influence_class:C1
By influence class (OR)
/v4/research-products?filter=impact.influence_class:C1|C2
By popularity class
/v4/research-products?filter=impact.popularity_class:C1
By impulse class (OR)
/v4/research-products?filter=impact.impulse_class:C1|C2|C3
By citation count class
/v4/research-products?filter=impact.citation_count_class:C1
By citation count (greater than)
/v4/research-products?filter=impact.citation_count:>100
By citation count (less than)
/v4/research-products?filter=impact.citation_count:<10
By citation count (exact)
/v4/research-products?filter=impact.citation_count:50
Filter — Publisher and host
By publisher
/v4/research-products?filter=publisher:Springer
By publisher (OR)
/v4/research-products?filter=publisher:Springer|Elsevier
By host datasource
/v4/research-products?filter=host_datasource.id:opendoar____::1234
By collected-from datasource
/v4/research-products?filter=collected_from.id:opendoar____::5678
Filter — Grants and funding
By project ID
/v4/research-products?filter=grants.project_id:corda__h2020::abcdef123456
By grant code
/v4/research-products?filter=grants.code:101000360
By funder
/v4/research-products?filter=grants.funder_short_name:EC
By funder (OR)
/v4/research-products?filter=grants.funder_short_name:EC|NIH|NSF
By funding stream
/v4/research-products?filter=grants.funding_stream_id:H2020
Has grant
/v4/research-products?filter=has_grant:true
No grant
/v4/research-products?filter=has_grant:false
Filter — Affiliations and communities
By organization
By community
/v4/research-products?filter=communities.id:egi
Filter — Other
By language
/v4/research-products?filter=language:English
By language (OR)
/v4/research-products?filter=language:English|German|French
Has license
/v4/research-products?filter=has_license:true
Combined filter examples
Open Access publications from 2023+
/v4/research-products?filter=type:publication,from_publication_year:2023,best_oa.rights:Open Access
EC-funded datasets with license
/v4/research-products?filter=type:dataset,grants.funder_short_name:EC,has_license:true
Greek peer-reviewed gold OA
High-impact software
/v4/research-products?filter=type:software,impact.citation_count:>50
Diamond journal + SDG 3 + publicly funded
/v4/research-products?filter=is_in_diamond_journal:true,sdg:3,is_publicly_funded:true
Facets: datasets by country and funder
Group by: OA color for EC-funded publications
/v4/research-products?filter=type:publication,grants.funder_short_name:EC&group_by=oa_color