# Springer Nature — 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 and retrieve metadata for millions of articles, books, and journals from Springer Nature's research library using DOI or ISBN lookups, with powerful filtering and pagination options. Get detailed information about academic publications including journal details, article metadata, and book information to power your research tools and discovery applications.

**Category:** Education | **Website:** [springer.com/](https://springer.com/) | **Docs:** [parse.bot/marketplace/dee0fc9c-a1f3-4d7a-b666-6a5dc490d109/springer-com-api](https://parse.bot/marketplace/dee0fc9c-a1f3-4d7a-b666-6a5dc490d109/springer-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/springer-nature/`
**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 details

Retrieve full metadata for a journal article or book chapter by its DOI. Returns title, abstract, authors, journal name, bibliographic information, and references.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `doi` | string | Yes | Digital Object Identifier (DOI) of the article or chapter (e.g. 10.1038/nature12373). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/springer-nature/get-article-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"doi":"<string>"}'
```

### Get book details

Retrieve metadata for a book by its DOI or ISBN. Returns title, authors/editors, description (if available), and a list of chapters with their titles, URLs, and DOIs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `doi` | string | Yes | DOI or ISBN of the book (e.g. 10.1007/978-3-319-10696-0). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/springer-nature/get-book-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"doi":"<string>"}'
```

### Get journal info

Retrieve metadata and metrics for a journal by its numeric Springer journal ID. Returns title, aims-and-scope description, metrics (impact factor, downloads, publishing model), and Electronic ISSN.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `journal_id` | string | Yes | Numeric Springer journal ID (e.g. 12879, 10994). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/springer-nature/get-journal-info \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"journal_id":"<string>"}'
```

### Get springer

Retrieve structured metadata for a paper by its DOI or Springer URL. Returns authors, publication year, title, journal name, volume, issue, start page, and abstract. Accepts either a bare DOI (e.g. 10.1038/nature12373) or a full Springer article/chapter URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `paper` | string | Yes | DOI (e.g. 10.1038/nature12373) or full Springer article/chapter URL (e.g. https://link.springer.com/article/10.1038/nature12373). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/springer-nature/get-springer \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"paper":"<string>"}'
```

### Search articles

Full-text search over Springer Nature Link content. Returns paginated results (up to 20 per page) with title, DOI, authors, content type, and snippet for each hit. Supports filtering by content type, date range, and sort order. Pagination via integer page counter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `content_type` | string | No | Type of content to filter by. |
| `end_year` | integer | No | End year for date range filter. Must be used together with start_year. |
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | Search query keywords. |
| `sort` | string | No | Sort order for results. |
| `start_year` | integer | No | Start year for date range filter. Must be used together with end_year. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/springer-nature/search-articles \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"content_type":"<string>","end_year":"<integer>","page":"<integer>","query":"<string>","sort":"<string>","start_year":"<integer>"}'
```

## 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.