> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Consensus

> Consensus provides evidence-based search across scientific research papers.

![Consensus logo](https://mintcdn.com/composio-preview/NPf8agM6UrvZD-Iu/images/toolkits/consensus.svg?fit=max\&auto=format\&n=NPf8agM6UrvZD-Iu\&q=85\&s=34be66a96d26c50a494ba3802d95ec77)

* **Category:** web search & research
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 1
* **Triggers:** 0
* **Slug:** `CONSENSUS`
* **Version:** 20261101\_00

## Tools

> [accordion] Search Research Papers
>
> **Slug:** `CONSENSUS_SEARCH_PAPERS`
>
> Search Consensus for research papers with study, publication, and access filters, returning one result page and an optional continuation cursor. Search usage counts against plan calls, full-text excerpts are available on paid plans, and the underlying quick search endpoint is deprecated and scheduled for removal on 2027-02-07.
>
> #### Input Parameters
>
> **human** `boolean`
>
> Set true to include only human studies.
>
> **query** `string` *required*
>
> Research question or topic to search for.
>
> **country** `string`
>
> Comma-separated ISO 3166-1 alpha-2 study-country codes such as us or gb. Unknown codes are ignored; if none resolve, this filter is not applied.
>
> **domains** `array`
>
> Academic fields to include. These are research domains such as med for medicine or cs for computer science, not web domains.
>
> **sjr\_max** `integer`
>
> Exclude journals in lesser SJR quartiles; 1 is the best quartile.
>
> **sjr\_min** `integer`
>
> Exclude journals in better SJR quartiles; 1 is the best quartile.
>
> **year\_max** `integer`
>
> Exclude papers published after this year; required when month\_max is set.
>
> **year\_min** `integer`
>
> Exclude papers published before this year; required when month\_min is set.
>
> **month\_max** `integer`
>
> Exclude papers after this month within year\_max. Requires year\_max.
>
> **month\_min** `integer`
>
> Exclude papers before this month within year\_min. Requires year\_min.
>
> **page\_size** `integer`
>
> Results to request for this page. The plan-dependent maximum is unpublished; oversized values are capped and the applied value is returned.
>
> **controlled** `boolean`
>
> Set true to include only controlled studies.
>
> **next\_cursor** `string`
>
> Continuation value returned by a previous call. Omit for page 0. Pages after page 0 require Enterprise access; pass the returned value back unchanged.
>
> **open\_access** `boolean`
>
> Set true to include only open-access papers.
>
> **study\_types** `array`
>
> Only include papers with one of these documented study types. Values are sent as repeated study\_types query parameters.
>
> **citation\_min** `integer`
>
> Exclude papers with fewer citations.
>
> **duration\_max** `integer`
>
> Maximum study duration in days.
>
> **duration\_min** `integer`
>
> Minimum study duration in days.
>
> **journal\_name** `string`
>
> Preferred journal name. Matching journals rank higher, but other journals are not excluded.
>
> **medical\_mode** `boolean`
>
> Set true to search top medical journals and guidelines, approximately 8 million documents.
>
> **publisher\_name** `string`
>
> Comma-separated publisher display names to include.
>
> **sample\_size\_min** `integer`
>
> Exclude studies with a smaller sample size.
>
> **exclude\_preprints** `boolean`
>
> Set true to exclude preprints and include only peer-reviewed papers.
>
> **clinical\_guideline** `boolean`
>
> Set true to include only papers classified as clinical guidelines.
>
> **include\_semantic\_score** `boolean`
>
> Set true to include semantic\_score in each result.
>
> **include\_full\_text\_chunks** `boolean`
>
> Include query-relevant full-text excerpts. Enterprise customers only; leave false on other plans.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
