# Research Funding API
> Discover the funding and projects behind research — as an API over OpenAIRE, the open research graph that links scholarly outputs to the grants and funders that paid for them. Search funded research projects (grants) by keyword and filter by funder — the European Commission, NIH, NSF, UKRI, DFG, Wellcome and many more — and get each project's title, grant code, acronym, funder, start and end dates, funded amount and summary. Search publications too, with their title, authors, year, DOI, type, publisher, open-access status and whether they were publicly funded. It is the place to find research grants and the money behind science — ideal for research-funding discovery, science-policy analysis, grant intelligence, reporting and open-science tooling. A research-funding / projects resource — distinct from DOI registries (Crossref, DataCite) and scholarly-metadata indexes (OpenAlex). Open data from OpenAIRE (CC BY).

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/openaire-api/..."
```

## Pricing
- **Free** (Free) — 2,300 calls/Mo, 2 req/s
- **Starter** ($7/Mo) — 46,000 calls/Mo, 8 req/s
- **Pro** ($21/Mo) — 230,000 calls/Mo, 20 req/s
- **Mega** ($57/Mo) — 835,000 calls/Mo, 50 req/s

## Endpoints

### Research Funding

#### `GET /v1/projects` — Search funded research projects (grants)

**Parameters:**
- `q` (query, optional, string) — Search keywords Example: `graphene`
- `funder` (query, optional, string) — Funder id (EC, NIH, NSF, UKRI, …)
- `limit` (query, optional, string) — Max results (1-50, default 20)

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/openaire-api/v1/projects?q=graphene"
```

**Response:**
```json
{
    "data": {
        "count": 20,
        "query": "graphene",
        "total": 1958,
        "projects": [
            {
                "code": "FW04020064",
                "title": "Research and development of ecological drinking water filter using a graphene nanolayer",
                "funder": "Technology Agency of the Czech Republic",
                "acronym": null,
                "summary": "The main goal of the project is research and development of an ecological and very efficient drinking water filter for households based on the adsorption of harmful substances on the graphene nanolayer. The implementation of the project will bring a new solution for the filtration of drinking water in order to eliminate the disadvantages of existing filtration systems. It is an innovative use of state-of-the-art nanotechnologies and the expected result of the project will exceed the technical parameters of currently known solutions. The output of the project will be a prototype of a new graphe",
                "currency": null,
                "end_date": "2023-12-31",
                "start_date": "2022-01-01",
                "total_cost": "0.0",
                "funded_amount": "0.0"
            },
            {
                "code": "GM24-11702M",
                "title": "Tunable graphene/SiC optoelectronics",
                "funder": "Czech Science Foundation",
                "acronym": null,
                "summary": "ABC-stacked trilayer graphene is known to ex
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/publications` — Search publications (OA & funding status)

**Parameters:**
- `q` (query, optional, string) — Search keywords Example: `graphene`
- `limit` (query, optional, string) — Max results (1-50, default 20)

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/openaire-api/v1/publications?q=graphene"
```

**Response:**
```json
{
    "data": {
        "count": 20,
        "query": "graphene",
        "total": 324500,
        "publications": [
            {
                "doi": "10.1002/9783527672790",
                "type": "publication",
                "year": "2014",
                "title": "Functionalization of Graphene",
                "authors": [],
                "publisher": "Wiley",
                "open_access": true,
                "access_right": "Open Access",
                "publicly_funded": false
            },
            {
                "doi": "10.1002/9783527651122",
                "type": "publication",
                "year": "2012",
                "title": "Graphene",
                "authors": [],
                "publisher": "Wiley",
                "open_access": false,
                "access_right": "Closed Access",
                "publicly_funded": false
            },
            {
                "doi": "10.1166/jnn.2015.9283",
                "type": "publication",
                "year": "2015",
                "title": "Oscillatory Behavior of Graphene Nanoflake on Graphene Nanoribbon",
                "authors": [
                    "Jeong Won, Kang",
                    "Kang Whan, Lee"
                ],
                "publisher": "American Scientific Publishers",
                "open_access": false,
                "access_right": "unspecified",
                "publicly_funded": false
            },
            {
                "doi": "10.1007/
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Endpoint catalogue, funders & notes

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/openaire-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "OpenAIRE is the open research graph that links research outputs to the funding and projects behind them. /v1/projects?q=graphene searches funded research projects (grants), returning each project's title, grant code, acronym, funder, start/end dates, funded amount and summary — filter by funder with funder=EC (European Commission), NIH, NSF, UKRI, DFG, … (see funders). /v1/publications?q=graphene searches research publications, returning title, authors, year, DOI, type, publisher and — distinctively — their open-access status and whether they are publicly funded. Data from OpenAIRE (CC BY). A research-funding / projects resource — distinct from DOI registries (Crossref, DataCite) and scholarly-metadata indexes (OpenAlex): it is the place to discover grants and the money behind research. Ideal for research-funding discovery, science-policy, reporting and open-science tooling.",
        "source": "OpenAIRE — open research graph (api.openaire.eu)",
        "funders": {
            "EC": "European Commission",
            "WT": "Wellcome Trust",
            "ANR": "Agence Nationale de la Recherche (FR)",
            "ARC": "Australian Research Council",
            "DFG": "Deutsche Forschungsgemeinschaft",
            "FCT": "Fundação para a Ciência e a Tecnologia (PT)",
            "NIH": "National Institutes of Health (US)",
            "NSF": "National Science Foundation (US)",
            "NWO": "Dutch Research Council",
       
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/openaire-api
OpenAPI spec: https://www.oanor.com/api/openaire-api/openapi.json
