Skip to main content
search finds peer-reviewed papers for a query and returns them ranked, in one call. Your assistant reads the papers and writes the answer. It’s the right tool for lookups and for questions your assistant can answer from a list of papers. For a question that needs several research steps and a written, cited answer, use create_thread instead. See Search vs Threads. search works without an account at reduced limits. ChatGPT Deep Research may call it several times with different queries and filters while it builds a report.

Parameters

Every parameter except query is optional.

Response

search returns a text payload written for AI agents: the ranked papers (title, link, authors, year, citation count, journal, paper id, abstract, and on paid plans full-text excerpts), plus instructions to cite each paper inline by its number.
Paid plans also get DOIs and full-text excerpts from open-access papers: up to 3 per paper for the first 5 eligible papers, and 12,000 characters per search. When a search reaches that limit, the excerpt at the limit is cut short with ... and later papers show none. In ChatGPT, results appear in the Consensus widget. Each paper’s id: line carries the id to pass to get_full_text, which reads the paper’s complete text. Papers marked full text available are open access, so their complete text can be returned. The mark only appears when get_full_text is available to you: on a Free plan, or before the tool reaches your account, id lines carry no mark. ChatGPT gets the same in each paper’s paper_id and full_text_available fields. On a paid plan, if you’ve selected your institution in Consensus settings, a paper in the first 50 results can carry an Access through your institution link that opens the full text through your library. ChatGPT gets it as the paper’s institutional_access_url.
Need structured JSON? Use the Consensus API, which shares your monthly allowance with MCP.

Example prompts

  • “What does the research say about the effectiveness of remote work on productivity?”
  • “Find RCTs and meta-analyses since 2020 on cognitive behavioral therapy for anxiety”
  • “Search for high-quality human studies on gut microbiome and mental health with at least 100 participants”
  • “Recent research on large language model hallucination from top-tier journals”

Good to know

  • Cost: one call per 100 papers returned, rounded up, with a minimum of one call per search. See plans and access.
  • Papers per search: your plan sets the maximum page_size, from 3 without an account up to 1,000 on Enterprise.
  • Rate limits: set by your plan. See plans and access.