# Nature · Search articles

Get news and media data with Nature · Search articles from Alexandria through one Spiral API key. Find articles by topic, author or title across Nature journals. For browsing one journal or subject without a query prefer `list_journal_articles`, `get_issue` or `latest_by_subject` (no challenge on those surfaces). Pass `page` to continue. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

- Provider: Alexandria
- Category: News & Media
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `nature-com/papers/search_articles`
- Page: https://spiral.ai/tools/alexandria/nature-com/papers/search_articles

## 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 |
| --- | --- | --- | --- | --- |
| `q` | text |  | — | Free-text query (title, abstract and full text). |
| `page` | number | 1 to 1000 | — | 1-based page of 50 results; default 1. |
| `order` | one of | relevance, date_desc, date_asc | — | Sort order; default `relevance`. |
| `title` | text |  | — | Words that must appear in the title. |
| `author` | text |  | — | Author surname or full name. |
| `journal` | text |  | — | Journal path code (pcode) as used in nature.com URLs: `nature`, `ncomms`, `srep`, `neuro`, `nrn`, `nbt`, ... Pattern: ^[a-z][a-z0-9-]{1,40}$. |
| `subject` | text |  | — | Subject slug as used in /subjects/{slug}, e.g. `hippocampus`, `neuroscience`. Pattern: ^[a-z0-9][a-z0-9-]{1,80}$. |
| `date_range` | text |  | — | `today`, `last_7_days`, `last_30_days`, `last_year`, `last_2_years`, `last_5_years` or an inclusive year range `YYYY-YYYY`. Pattern: ^(today\|last_7_days\|last_30_days\|last_year\|last_2_years\|last_5_years\|[12][0-9]{3}-[12][0-9]{3})$. |
| `article_type` | one of | research, reviews, news-and-views, research-highlights, protocols, news, comments-and-opinion, books-and-arts, special-features, editorial, correspondence, multimedia | — | Article type facet. |

## 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": "nature-com/papers/search_articles",
    "input": {
      "q": "<q>"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=nature-com%2Fpapers%2Fsearch_articles

## Common questions

### Nature · Search articles

**How much does Nature · Search articles 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 Nature · Search articles through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "nature-com/papers/search_articles"` 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 Nature · Search articles?**

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

**Can my AI agent use Nature · Search articles?**

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

