# Europe PMC · Search

Get health and medical data with Europe PMC · Search from Alexandria through one Spiral API key. Start here to find papers or preprints on a topic, method, gene, dataset or grant, then call `get` for the abstract and full record, `annotations` for the genes, diseases, chemicals and accessions text-mined from an article, or `full_text` when a result's `full_text` is `available`. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

- Provider: Alexandria
- Category: Health
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `europepmc-org/publications/search`
- Page: https://spiral.ai/tools/alexandria/europepmc-org/publications/search

## Pricing

$0.00873 per call.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 5 minutes
- Longest run, end to end: 225 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `query` (required) | text |  | — | Free text or Europe PMC query syntax, e.g. `furin cleavage site`, `"base editing" AND TITLE:mouse`, `AUTH:"Doudna JA"`, `GRANT_AGENCY:"Wellcome Trust"`, `MESH:"Alzheimer Disease"`. Use `*` to match everything and narrow with filters. |
| `sort` | one of | relevance, newest, most_cited | relevance | `relevance` (Europe PMC's ranking), `newest` (first publication date) or `most_cited`. |
| `limit` | number | 1 to 100 | 10 | Results per page. |
| `cursor` | text |  | — | `next_cursor` from the previous page. Repeat the same query, filters, sort and limit with it. |
| `source` | list |  | — | Only these record sources, e.g. `["preprint"]`. |
| `license` | one of | commercial_reuse, cc0, cc_by, cc_by_sa, cc_by_nd, cc_by_nc, cc_by_nc_sa, cc_by_nc_nd | — | Only articles under this licence. `commercial_reuse` is any of CC0, CC BY, CC BY-SA and CC BY-ND. |
| `section` | one of | title, title_abstract, body, introduction, methods, results, discussion, conclusions, figures, tables, supplementary, data_availability, acknowledgements | — | Confine `query` to one part of the article: `title`, `title_abstract`, `body` (full text), or a full-text section. Section searches match only articles whose full text Europe PMC holds. |
| `to_date` | text |  | — | Latest first-publication date: YYYY, YYYY-MM or YYYY-MM-DD, inclusive. Pattern: ^[0-9]{4}(-[0-9]{2}(-[0-9]{2})?)?$. |
| `accession` | text |  | — | Only articles that mention this database accession, as Europe PMC text-mines them: a PDB ID (`6VXX`), UniProt accession (`P04637`), GEO series (`GSE2034`), ENA/GenBank accession, clinical-trial ID (`NCT04368728`), DOI of a dataset and others. |
| `from_date` | text |  | — | Earliest first-publication date: YYYY, YYYY-MM or YYYY-MM-DD. Pattern: ^[0-9]{4}(-[0-9]{2}(-[0-9]{2})?)?$. |
| `open_access` | true or false |  | — | true: only open-access records; false: only records that are not. |
| `full_text_only` | true or false |  | — | true: only articles whose full text `full_text` returns (open access in Europe PMC under a commercial-reuse licence). |

## Example

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "europepmc-org/publications/search",
    "input": {
      "query": "<query>"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=europepmc-org%2Fpublications%2Fsearch

## Common questions

### Europe PMC · Search

**How much does Europe PMC · Search cost?**

$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use Europe PMC · Search through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "europepmc-org/publications/search"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with Alexandria to use Europe PMC · Search?**

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

**Can my AI agent use Europe PMC · Search?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

