> ## Documentation Index
> Fetch the complete documentation index at: https://docs.consensus.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick start: Search

> Find ranked papers for a query in one request, and see when search is the right Consensus API endpoint.

`GET /v1/search` returns ranked papers for a query in a single request. Use it when your code or your own model needs the papers themselves: titles, journals, citation counts, links, and full-text excerpts.

## When to use search

Search is the right fit when you want the papers and plan to do the reasoning yourself.

* **Lookups:** find the papers on a specific question, author, or method.
* **Your own pipeline:** feed ranked papers and full-text excerpts into your own LLM, agent, or scoring step.
* **High volume:** screen many queries or targets quickly. Each request costs one call per 100 papers returned.
* **Structured filtering:** narrow by study design, date, journal quality, sample size, field, or country.

Want Consensus to read the papers and write a cited answer for you instead? Use [Threads](https://docs.consensus.app/api-quickstart-threads.md).

## Make a request

Store your key in an environment variable named `CONSENSUS_API_KEY`, then send a `query`:

```bash theme={null}
curl -G "https://api.consensus.app/v1/search" -H "x-api-key: $CONSENSUS_API_KEY" \
  --data-urlencode "query=does creatine improve working memory" \
  --data-urlencode "study_types=rct,meta-analysis" \
  --data-urlencode "year_min=2015"
```

Each result in `results` carries the paper's `title`, `authors`, `journal_name`, `publish_year`, `citation_count`, `doi`, a Consensus `url`, and a one-sentence `takeaway`, plus its `paper_id` and `full_text_available`. On a paid plan, open-access results also carry `full_text_chunks`: the passages from the paper's full text that answer your query.

## Go further

* **Full-text excerpts:** returned on paid plans for open-access papers. See [Full text in the API](https://docs.consensus.app/api-full-text.md).
* **Complete text:** pass the `paper_id` of results where `full_text_available` is `true` to `GET /v1/papers/full_text` to read the whole paper as Markdown. Paid plans. See [complete text](https://docs.consensus.app/api-full-text.md#complete-text).
* **Institutional full-text links:** on a paid plan, if you've selected your institution in Consensus settings, the first 50 results can include an `institutional_access_url` that opens the full text through your library.
* **More results:** raise `page_size` and page through with `page`. Your plan sets the maximum. See [plans and access](https://docs.consensus.app/api-plans-and-access.md).
* **Every parameter:** see the [search endpoint reference](https://docs.consensus.app/api-reference/search.md).

## Use cases

> [card] [Abstract screening](https://docs.consensus.app/use-cases/abstract-screening.md)
>
> Screen candidate papers against inclusion criteria at scale.

> [card] [Citation verification](https://docs.consensus.app/use-cases/citation-verification.md)
>
> Check that a claim is backed by the paper it cites.

> [card] [Extract values from full text](https://docs.consensus.app/use-cases/extract-values-from-full-text.md)
>
> Pull doses, effect sizes, and sample sizes from full-text excerpts.

> [card] [Scheduled research pipeline](https://docs.consensus.app/use-cases/scheduled-research-pipeline.md)
>
> Monitor a field on a schedule and report what's new.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.