# Pubmed — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search millions of biomedical research papers and instantly access their metadata including titles, abstracts, authors, and publication details from PubMed's comprehensive database. Discover related articles and build your research by finding connected papers on similar topics.

**Category:** Healthcare | **Website:** [pubmed.com/](https://pubmed.com/) | **Docs:** [parse.bot/marketplace/c0023712-d9cb-4f83-a52a-9e4923b49e00/pubmed-com-api](https://parse.bot/marketplace/c0023712-d9cb-4f83-a52a-9e4923b49e00/pubmed-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-pubmed-com-api-c0023712/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_article

Retrieve full metadata for a single PubMed article by its PMID. Returns detailed information including full abstract (with labeled sections), author names with affiliations, MeSH terms, keywords, journal details, DOI, and publication types.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `pmid` | string | Yes | PubMed ID (numeric identifier for the article). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pubmed-com-api-c0023712/get_article \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pmid":"<string>"}'
```

### get_related_articles

Find articles related to a given PubMed article using NCBI's computed similarity scores. Returns article summaries for papers the system considers topically similar. Very new articles may not yet have computed relationships.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of related articles to return (1-100). |
| `pmid` | string | Yes | PubMed ID of the source article to find related papers for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pubmed-com-api-c0023712/get_related_articles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","pmid":"<string>"}'
```

### search_articles

Full-text search across PubMed's biomedical literature index. Returns paginated article summaries matching the query term, with optional date range and sort order filtering. Results are auto-iterated; each article summary includes PMID, title, authors, journal, publication date, DOI, and publication types.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `max_date` | string | No | Maximum publication date filter in YYYY/MM/DD or YYYY format. |
| `min_date` | string | No | Minimum publication date filter in YYYY/MM/DD or YYYY format. |
| `page` | integer | No | Page number for pagination (1-based). |
| `per_page` | integer | No | Number of results per page (1-100). |
| `query` | string | Yes | Search query using PubMed query syntax. Supports boolean operators (AND, OR, NOT), field tags ([ti] for title, [au] for author, [mh] for MeSH), and phrase matching with quotes. |
| `sort` | string | No | Sort order for results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pubmed-com-api-c0023712/search_articles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"max_date":"<string>","min_date":"<string>","page":"<integer>","per_page":"<integer>","query":"<string>","sort":"<string>"}'
```