Pubmed Search Articles
pubmed_search_articlesRead-only
Search PubMed articles using full query syntax and filters. Returns PMIDs with optional summaries, supports field-specific filters, date ranges, and pagination.
Instructions
Search PubMed with full query syntax, filters, and date ranges. Returns PMIDs and optional brief summaries. Supports field-specific filters (author, journal, MeSH terms), common filters (language, species, free full text), and pagination via offset for paging through large result sets.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Sort order: relevance (default), pub_date (newest first), author, or journal | relevance |
| query | Yes | PubMed search query (supports full NCBI syntax) | |
| author | No | Filter by author name (e.g. "Smith J") | |
| offset | No | Result offset for pagination (0-based) | |
| journal | No | Filter by journal name | |
| species | No | Filter by species | |
| language | No | Filter by language (e.g. "english") | |
| dateRange | No | Filter by date range. The filter is applied only when both `minDate` and `maxDate` are non-empty; either one empty disables the entire date range. | |
| meshTerms | No | Filter by MeSH terms. Multiple terms are AND'd — all must match. | |
| maxResults | No | Maximum results to return | |
| hasAbstract | No | Only include articles with abstracts | |
| freeFullText | No | Only include free full text articles | |
| summaryCount | No | Fetch brief summaries for top N results (0 = PMIDs only) | |
| publicationTypes | No | Filter by publication type (e.g. "Review", "Clinical Trial", "Meta-Analysis"). Multiple values are OR'd — any match qualifies. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pmids | Yes | PubMed IDs | |
| query | Yes | Original query | |
| notice | No | Optional guidance when results are empty or paging overshot — e.g. how to broaden filters or reset offset. Absent on successful result pages. | |
| offset | Yes | Result offset used | |
| searchUrl | Yes | PubMed search URL | |
| summaries | Yes | Brief summaries (empty array when summaryCount is 0) | |
| totalCount | Yes | Total matching articles | |
| appliedFilters | Yes | Normalized filter values that were applied to the PubMed query | |
| effectiveQuery | Yes | Sanitized query sent to PubMed after applying all active filters |