# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/pubmed/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/pubmed/get-article \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/pubmed/get-related-articles \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/pubmed/search-articles \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"max_date":"<string>","min_date":"<string>","page":"<integer>","per_page":"<integer>","query":"<string>","sort":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.