# 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. Each call is automatically billed to your wallet in USDC.

## Access

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

## 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/parse-springer-com-api-dee0fc9c/get_article_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-springer-com-api-dee0fc9c/get_book_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-springer-com-api-dee0fc9c/get_journal_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-springer-com-api-dee0fc9c/get_springer \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-springer-com-api-dee0fc9c/search_articles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content_type":"<string>","end_year":"<integer>","page":"<integer>","query":"<string>","sort":"<string>","start_year":"<integer>"}'
```
