# Semantic Scholar · Search papers

Get developer and code data with Semantic Scholar · Search papers from Alexandria through one Spiral API key. Discover papers on a topic before calling get_paper, get_citations or get_references. Results are keyword matches, most-cited first, with no relevance ranking. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

- Provider: Alexandria
- Category: Developer
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `semanticscholar-org/papers/search_papers`
- Page: https://spiral.ai/tools/alexandria/semanticscholar-org/papers/search_papers

## 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 |  | — | Search text, matched against titles and abstracts. By default every unquoted word must appear, so put each multi-word concept in double quotes. Bulk-search syntax: `fish ladder` (all words), `fish \| ladder` (either), `fish -ladder` (exclude), `"fish ladder"` (phrase), `fish*` (prefix), `fish~3` (fuzzy). |
| `sort` | one of | citationCount:desc, citationCount:asc, publicationDate:desc, publicationDate:asc, paperId:asc, paperId:desc | citationCount:desc | Result order. The source has no relevance order. `citationCount:desc` (default) lists the most-cited first. `publicationDate:desc` lists the newest first. Undated papers come last, and some journal papers carry a future issue date. The `paperId` orders are arbitrary but stay stable while paging through large result sets. |
| `year` | text |  | — | Publication year or range: `2019`, `2016-2020`, `2010-` (since), `-2015` (until). Pattern: ^[0-9]{4}(-[0-9]{0,4})?$\|^-[0-9]{4}$. |
| `limit` | number | 1 to 200 | 25 | Items per page (1-200, default 25). |
| `venue` | list |  | — | Restrict to these venues (names or ISO4 abbreviations, e.g. `Nature`, `ICLR`). |
| `continuation` | text |  | — | `continuation` from the previous page; the other inputs must be repeated unchanged. Omit or null for the first page. |
| `fields_of_study` | list |  | — | Restrict to these fields of study (e.g. `Computer Science`, `Medicine`, `Physics`). |
| `open_access_only` | true or false |  | — | Only papers with a public PDF. |
| `publication_types` | list |  | — | Restrict to these publication types. |
| `min_citation_count` | number | 0 to 1000000 | — | Only papers cited at least this many times. |
| `publication_date_or_year` | text |  | — | Date range `<start>:<end>` with YYYY, YYYY-MM or YYYY-MM-DD parts, either side open (`2020-01-01:`, `:2019-12`). Pattern: ^[0-9]{4}(-[0-9]{2}){0,2}(:([0-9]{4}(-[0-9]{2}){0,2})?)?$\|^:[0-9]{4}(-[0-9]{2}){0,2}$. |

## 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": "semanticscholar-org/papers/search_papers",
    "input": {
      "query": "<query>"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=semanticscholar-org%2Fpapers%2Fsearch_papers

## Common questions

### Semantic Scholar · Search papers

**How much does Semantic Scholar · Search papers 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 Semantic Scholar · Search papers through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "semanticscholar-org/papers/search_papers"` 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 Semantic Scholar · Search papers?**

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

**Can my AI agent use Semantic Scholar · Search papers?**

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

