Spiral gives your agent every tool with one account. Browse the tools →

AlexandriaDeveloperAvailable now

Semantic Scholar · Search papers

semanticscholar-org/papers/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.

Pricing

$0.00873 per call.

Limits

Runs
In the background
Returns
json
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

FieldKindDefaultDescription
query requiredtext—

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).

sortone 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.

yeartext—

Publication year or range: 2019, 2016-2020, 2010- (since), -2015 (until). Pattern: ^[0-9]{4}(-[0-9]{0,4})?$|^-[0-9]{4}$.

limitnumber
1 to 200
25

Items per page (1-200, default 25).

venuelist—

Restrict to these venues (names or ISO4 abbreviations, e.g. Nature, ICLR).

continuationtext—

continuation from the previous page; the other inputs must be repeated unchanged. Omit or null for the first page.

fields_of_studylist—

Restrict to these fields of study (e.g. Computer Science, Medicine, Physics).

open_access_onlytrue or false—

Only papers with a public PDF.

publication_typeslist—

Restrict to these publication types.

min_citation_countnumber
0 to 1000000
—

Only papers cited at least this many times.

publication_date_or_yeartext—

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}$.

Same request in code

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>"
    }
  }'

Frequently asked questions

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.