UKRI Gateway to Research
Gateway to Research (GtR) is the public database of projects funded by UK Research and Innovation, run by UKRI. Through ScholarMuse, an agent searches GtR projects by topic and gets each project's grant reference, lead organisation and department, lead funder, grant category, status, dates, total funded value and abstract. Investigator, organisation and year narrowing is applied by ScholarMuse to the top matches.
ScholarMuse tools: search_grants. Each successful call uses credits.
Ask your agent
What your agent gets back
Every record carries id, source, title, url, license, attribution and retrievedAt. The fields below are the data that comes from UKRI Gateway to Research.
search_grants
organization, pi, amount and dates are read from linked GtR resources (lead organisation, people, fund). If one of those lookups fails, that field is left empty.
- projectNumber
- GtR grant reference
- pi
- Up to two lead people: PI, fellow or manager
- organization
- Lead organisation name
- department
- Department at the lead organisation
- agency
- Lead funder within UKRI
- grantCategory
- GtR grant category
- status
- Project status as given by GtR
- startDate
- Funding start date (YYYY-MM-DD, UK time)
- endDate
- Funding end date (YYYY-MM-DD, UK time)
- amount
- Total funded value
- currency
- Currency of amount, normally GBP
- abstract
- Project abstract, cut at 2,000 characters
What it covers
- Projects in UKRI's Gateway to Research, searched by topic through the GtR API.
- amount is the total funded value of the project, not a yearly figure.
- Each record links to its project page on gtr.ukri.org.
Limits
- One call returns at most 25 projects (default 10). Without a funder choice, that number is shared between NIH, NSF and UKRI, so ask for UKRI only to fill it with UKRI projects.
- GtR project search has no investigator, organisation or date filter. ScholarMuse applies the year filter to the 100 most relevant matches, and the investigator and organisation filters to at most 40 of them, so a narrow filter can miss projects.
- The year filter uses the funding start year. Organisation matching is on the lead organisation only, and at most two people are read per project.
- Project outcomes, publications and partner organisations are not returned. An upstream search request is abandoned after 30 seconds.
How ScholarMuse reaches UKRI Gateway to Research
The connector calls the Gateway to Research API at gtr.ukri.org/gtr/api/projects with no API key, then follows each project's links to its fund, lead organisation and people records.
Search responses are cached for up to 12 hours and the linked fund, organisation and people records for up to 30 days, so changes to those can take that long to appear.
API key: the upstream API can be called without one, so you do not add one.
Licence and attribution
Licence: OGL-UK-3.0
Contains UKRI Gateway to Research data (gtr.ukri.org), Open Government Licence v3.0.
Records that come from UKRI Gateway to Research carry this licence and attribution. When you cite the data in a paper, follow UKRI Gateway to Research's own citation guidance.
