---
title: "Query for relevant papers."
method: GET
path: "/v1/quick_search"
---

# Query for relevant papers.

`GET /v1/quick_search`

## Query parameters

- `query` string, required — Query for research papers.
- `year_min` integer, nullable — Exclude papers before this year.
- `year_max` integer, nullable — Exclude papers after this year.
- `month_min` integer, nullable — Exclude papers before this month within year_min. Requires year_min.
- `month_max` integer, nullable — Exclude papers after this month within year_max. Requires year_max.
- `study_types` StudyTypeKeywordEnum[], nullable — Only include these study types.
- `human` boolean, nullable — Only include human studies.
- `sample_size_min` integer, nullable — Exclude studies with smaller sample sizes.
- `sjr_max` integer, nullable — Exclude journals in lesser quartiles, where 1 is the best quartile.
- `duration_min` integer, nullable — Minimum study duration (in days).
- `duration_max` integer, nullable — Maximum study duration (in days).
- `exclude_preprints` boolean, nullable — Exclude preprints, only include peer-reviewed papers.
- `publisher_name` string, nullable — Comma-separated publisher names to filter by. Matching is case-insensitive.
- `domain` string, nullable — Comma-separated academic field short codes, not email or web domains, to filter by. Valid values: med, bio, cs, chem, psych, phys, mat, eng, env, bus, econ, math, poli, agri, edu, soc, geol, geog, hist, art, philo, law, ling.
- `journal_name` string, nullable — Preferred journal name (e.g. "Nature"). Results from matching journals are surfaced higher; this does not exclude other journals.
- `clinical_guideline` boolean, nullable — Filter to papers classified as clinical guidelines.
- `medical_mode` boolean, nullable — Filter to top medical journals and guidelines, about 8M documents
- `include_semantic_score` boolean, nullable — Return semantic score in response if true.
- `include_full_text_chunks` boolean, nullable — Return query-relevant full-text excerpts. Enterprise customers only.
- `page` integer, nullable — Page number of results to return (0-indexed, max 50 pages). Enterprise customers only.

## Response `200`

Successful Response

- QuickSearchResponse
  - `results` QueryResult[], required — List of query results.
    - `abstract` string, required — Abstract of the paper.
    - `authors` string[], required — List of the paper's authors.
    - `doi` string, required — Digital Object Identifier for the document.
    - `journal_name` string, required — Publication journal of the paper.
    - `pages` string, required — Page range of the paper.
    - `publish_year` integer, required — Publication year of the paper.
    - `title` string, required — Title of the paper.
    - `url` string, required — Consensus URL for more paper details.
    - `volume` string, required — Journal volume of the paper.
    - `semantic_score` number, nullable — Optional semantic score of the paper; returned only when requested.
    - `citation_count` integer, required — Number of citations for the paper.
    - `study_type` string, nullable — Study type of the paper.
    - `takeaway` string, nullable — Key takeaway or summary from the paper abstract.
    - `publisher_name` string, nullable — Publisher name.
    - `full_text_chunks` string[], nullable — Query-relevant paper excerpts, returned only when requested. Enterprise customers only.
  - `page` integer, required — Current zero-indexed result page.
  - `is_end` boolean, required — True when no further page is indicated by the search backend.
  - `next_page` integer, nullable — Next zero-indexed page to request, if one is available. Enterprise customers only.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/consensus/apis/consensus-api.md) · [All operations](https://skmtc.dev/consensus/apis/consensus-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/consensus/consensus-api/revisions/f64ad4c890cc/schema)