search_papers
Search Google Scholar for academic papers by keyword.
Parameters
Parameter |
Type |
Default |
Description |
|---|---|---|---|
|
|
(required) |
Search query, using the same syntax as the Google Scholar search box. |
|
|
|
Maximum number of results to return. Clamped to the range 1–20. |
|
|
|
Filter to papers published in or after this year. |
|
|
|
Filter to papers published in or before this year. |
|
|
|
Sort order: |
|
|
|
Whether to include patents in the results. |
|
|
|
Number of results to skip, for paging. Pass the |
Return Value
Returns a SearchResponse containing:
query— the original query stringtotal_results— number of results returnedpapers— list ofPaperResultobjectsoffset— the offset this page starts atnext_offset— offset of the next page, ornullwhen there are no more results (the page came back short, or Scholar’s 1000-result limit is reached)
Paging
Call the tool again with the same arguments and offset set to
next_offset. Every page is at least one slow request to Google Scholar, so
page only when more results are really needed; narrowing the query (years,
more specific terms) is usually better than reading deep into a result list.
Examples
Basic keyword search:
{
"query": "large language models instruction tuning",
"max_results": 10
}
Filter by year range:
{
"query": "graph neural networks",
"max_results": 5,
"year_from": 2021,
"year_to": 2024
}
Sort by date, exclude patents:
{
"query": "protein structure prediction AlphaFold",
"sort_by": "date",
"include_patents": false
}