# NIH API: Search PubMed articles > Finds PubMed medical and life-science articles by topic, with publication details and free full-text links when PubMed confirms them. Unofficial. Not affiliated with or endorsed by NIH. - Page: https://fous.com/methods/pubmed.ncbi.nlm.nih.gov/search-articles - Method: `pubmed.ncbi.nlm.nih.gov/search_articles`, version 1 - Website: pubmed.ncbi.nlm.nih.gov - Returns: title, authors, journal, publication date, article type, abstract excerpt, free full-text link, PubMed link, PubMed ID, DOI - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `sort` | string | no | `"newest"` | Order by relevance or newest publication, for example newest. One of "relevance", "newest". Default "relevance". | | `query` | string | yes | `"intermittent fasting blood pressure"` | Topic in plain words, for example intermittent fasting blood pressure. | | `end_year` | integer | no | `2024` | Last publication year, for example 2024. | | `start_year` | integer | no | `2022` | First publication year, for example 2020. | | `max_results` | integer | no | `5` | Maximum number of articles to return, for example 20 (up to 100). Default 20. | | `article_type` | string | no | `"systematic_review"` | Article type, for example systematic_review. One of "any", "clinical_trial", "randomized_controlled_trial", "review", "systematic_review", "meta_analysis". Default "any". | | `free_full_text_only` | boolean | no | `true` | Only include articles PubMed marks as free full text, for example true. Default false. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "sort": "newest", "query": "intermittent fasting blood pressure", "end_year": 2024, "start_year": 2022, "max_results": 5, "article_type": "systematic_review", "free_full_text_only": true } ``` Its output: ```json { "articles": [ { "doi": "10.3390/nu16203533", "title": "Is Fasting Superior to Continuous Caloric Restriction for Weight Loss and Metabolic Outcomes in Obese Adults? A Systematic Review and Meta-Analysis of Randomized Clinical Trials.", "authors": "Víctor Siles-Guerrero, Jose M Romero-Márquez, Rosa Natalia García-Pérez, et al.", "journal": "Nutrients", "pubmed_id": "39458528", "pubmed_link": "https://pubmed.ncbi.nlm.nih.gov/39458528/", "article_type": "Meta-Analysis", "abstract_excerpt": "BACKGROUND: fasting-based strategies (FBS) and continuous caloric restriction (CCR) are popular methods for weight loss and improving metabolic health. FBS alternates between eating and fasting periods, while CCR reduces daily calorie intake consistently. Both aim to create a calorie deficit, but it", "publication_date": "2024-10-18", "free_full_text_link": "https://pmc.ncbi.nlm.nih.gov/articles/PMC11510157/" }, { "doi": "10.1016/j.cjca.2024.02.004", "title": "Risks and Benefits of Intermittent Fasting for the Aging Cardiovascular System.", "authors": "Mualla Ozcan, Mahmoud Abdellatif, Ali Javaheri, et al.", "journal": "The Canadian journal of cardiology", "pubmed_id": "38354947", "pubmed_link": "https://pubmed.ncbi.nlm.nih.gov/38354947/", "article_type": "Systematic Review", "abstract_excerpt": "Population aging and the associated increase in cardiovascular disease rates pose serious threats to global public health. Different forms of fasting have become an increasingly attractive strategy to directly address aging and potentially limit or delay the onset of cardiovascular diseases. A growi", "publication_date": "2024-02-12", "free_full_text_link": null }, { "doi": "10.1186/s12937-023-00909-x", "title": "Combined versus independent effects of exercise training and intermittent fasting on body composition and cardiometabolic health in adults: a systematic review and meta-analysis.", "authors": "Mousa Khalafi, Michael E Symonds, Aref Habibi Maleki, et al.", "journal": "Nutrition journal", "pubmed_id": "38183054", "pubmed_link": "https://pubmed.ncbi.nlm.nih.gov/38183054/", "article_type": "Meta-Analysis", "abstract_excerpt": "INTRODUCTION AND AIM: Exercise training (Ex) and intermittent fasting (IF) are effective for improving body composition and cardiometabolic health overweight and obese adults, but whether combining Ex and IF induces additive or synergistic effects is less well established. We therefore, performed a ", "publication_date": "2024-01-06", "free_full_text_link": "https://pmc.ncbi.nlm.nih.gov/articles/PMC10770891/" } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"pubmed.ncbi.nlm.nih.gov/search_articles","input":{"sort":"newest","query":"intermittent fasting blood pressure","end_year":2024,"start_year":2022,"max_results":5,"article_type":"systematic_review","free_full_text_only":true}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Find recent systematic reviews on intermittent fasting and blood pressure published since 2020, free full text only - Search PubMed for randomized controlled trials of semaglutide and weight loss from 2022 to 2024, newest first - I need meta-analyses on vitamin D supplementation and depression risk, sorted by relevance, up to 30 results - Look up review articles about gut microbiome and type 2 diabetes on nih.gov published between 2018 and 2023 - Show me the newest clinical trials on mRNA vaccine side effects in adolescents, limited to 15 results with free full-text links ## Input schema ```json { "type": "object", "required": [ "query" ], "properties": { "sort": { "enum": [ "relevance", "newest" ], "type": "string", "default": "relevance", "description": "Order by relevance or newest publication, for example newest." }, "query": { "type": "string", "minLength": 1, "description": "Topic in plain words, for example intermittent fasting blood pressure." }, "end_year": { "type": "integer", "maximum": 2100, "minimum": 1800, "description": "Last publication year, for example 2024." }, "start_year": { "type": "integer", "maximum": 2100, "minimum": 1800, "description": "First publication year, for example 2020." }, "max_results": { "type": "integer", "default": 20, "maximum": 100, "minimum": 1, "description": "Maximum number of articles to return, for example 20 (up to 100)." }, "article_type": { "enum": [ "any", "clinical_trial", "randomized_controlled_trial", "review", "systematic_review", "meta_analysis" ], "type": "string", "default": "any", "description": "Article type, for example systematic_review." }, "free_full_text_only": { "type": "boolean", "default": false, "description": "Only include articles PubMed marks as free full text, for example true." } }, "additionalProperties": false } ``` ## Output schema ```json { "type": "object", "required": [ "articles" ], "properties": { "articles": { "type": "array", "items": { "type": "object", "required": [ "title", "authors", "journal", "publication_date", "article_type", "abstract_excerpt", "free_full_text_link", "pubmed_link", "pubmed_id", "doi" ], "properties": { "doi": { "type": [ "string", "null" ], "description": "Digital object identifier, when available.", "x-fous-developer": true }, "title": { "type": "string", "description": "Article title." }, "authors": { "type": "string", "description": "First three authors, followed by et al. if there are more." }, "journal": { "type": [ "string", "null" ], "description": "Journal name, when available." }, "pubmed_id": { "type": "string", "description": "PubMed identifier.", "x-fous-developer": true }, "pubmed_link": { "type": "string", "description": "PubMed article page." }, "article_type": { "type": [ "string", "null" ], "description": "PubMed publication type." }, "abstract_excerpt": { "type": [ "string", "null" ], "description": "First 300 characters of the abstract, when available." }, "publication_date": { "type": [ "string", "null" ], "description": "Publication date, as YYYY-MM-DD, YYYY-MM, or YYYY when only part is known." }, "free_full_text_link": { "type": [ "string", "null" ], "description": "A confirmed free full-text page, when available." } }, "additionalProperties": false }, "description": "Matching articles in the requested order." } }, "additionalProperties": false } ``` ## See more - [NIH API: Get PubMed article](https://fous.com/methods/pubmed.ncbi.nlm.nih.gov/get-article.md): Gets the full PubMed abstract and publication details for one article by title, PubMed link, or PubMed number (PMID). A title is searched in PubMed titles first and must closely match a found article. Some articles have no abstract or free full text. - [NIH API: Search grants](https://fous.com/methods/reporter.nih.gov/search-grants.md): Finds NIH research grants by topic, organisation, or researcher name. Searches the last five fiscal years by default. - [NIH API: Search diagnosis codes](https://fous.com/methods/clinicaltables.nlm.nih.gov/search-diagnosis-codes.md): Finds ICD-10-CM diagnosis codes and official names from a plain-language condition description, retrying with simplified wording when the first search finds nothing. - [NIH API: Get chemical facts by name or CAS number](https://fous.com/methods/pubchem.ncbi.nlm.nih.gov/get-chemical.md): Looks up a chemical on PubChem by common name or CAS number and returns its formula, molecular weight, names, description, SMILES, InChIKey and 2D structure image link. - [NIH API: Get chemical safety](https://fous.com/methods/pubchem.ncbi.nlm.nih.gov/get-chemical-safety.md): Looks up a chemical on PubChem by name or CAS number and returns its GHS hazard labels, route-specific first aid, flash point and workplace exposure limits. - [NIH API: Explain ICD-10-CM diagnosis code](https://fous.com/methods/clinicaltables.nlm.nih.gov/explain-diagnosis-code.md): Explains an ICD-10-CM diagnosis code with its official name, category, chapter, and whether it is billable, using the NLM Clinical Tables diagnosis table. - [NPR API: Search news](https://fous.com/methods/npr.org/search-news.md): Searches NPR-published articles by keyword, newest first or by best match, with optional publication dates, and returns each article's date, authors, section and summary. - [bioRxiv API: Search preprints](https://fous.com/methods/biorxiv.org/search-preprints.md): Finds bioRxiv and medRxiv preprints whose title, abstract or subject matches all topic words, within a posting date range, newest first. Adds published journal details when available. - [All NIH methods](https://fous.com/methods/nih.gov.md)