# Royal Society Publishing — 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 browse scientific articles, journals, and issues from the Royal Society Publishing platform, including filtering by subject, year, and latest publications. Access detailed information about specific articles, journals, and current issues to stay updated on peer-reviewed research.

**Category:** Education | **Website:** [royalsocietypublishing.org/](https://royalsocietypublishing.org/) | **Docs:** [parse.bot/marketplace/949d587d-aee5-4f43-a41c-15214ffb3bd8/royalsocietypublishing-org-api](https://parse.bot/marketplace/949d587d-aee5-4f43-a41c-15214ffb3bd8/royalsocietypublishing-org-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-royalsocietypublishing-org-api-949d587d/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### browse_by_subject

Browse articles by subject category ID. Returns paginated article results filtered by the given subject.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `subject_id` | string | Yes | Subject category ID (e.g. 24 for behaviour, 104 for ecology). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-royalsocietypublishing-org-api-949d587d/browse_by_subject \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","subject_id":"<string>"}'
```

### get_article_details

Get full details for an article by DOI or URL. Returns title, authors, abstract, keywords, publication date, journal name, DOI, and metrics. At least one of doi or url must be provided.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `doi` | string | No | Article DOI (e.g. 10.1098/rsbl.2026.0087). |
| `url` | string | No | Full article URL on royalsocietypublishing.org. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-royalsocietypublishing-org-api-949d587d/get_article_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"doi":"<string>","url":"<string>"}'
```

### get_current_issue

Get the current issue for a journal, including volume number, issue number, publication date, and a list of articles with their titles, authors, DOIs, and URLs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `journal_code` | string | Yes | Journal short code. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-royalsocietypublishing-org-api-949d587d/get_current_issue \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"journal_code":"<string>"}'
```

### get_issue

Get a specific issue of a journal by volume and issue number. Returns the issue metadata and list of articles.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `issue` | string | Yes | Issue number. |
| `journal_code` | string | Yes | Journal short code. |
| `volume` | string | Yes | Volume number. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-royalsocietypublishing-org-api-949d587d/get_issue \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"issue":"<string>","journal_code":"<string>","volume":"<string>"}'
```

### get_journal_info

Get metadata for a specific journal including description, ISSN, eISSN, and impact factor. Fields may be empty strings when the information is not available on the journal page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `journal_code` | string | Yes | Journal short code. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-royalsocietypublishing-org-api-949d587d/get_journal_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"journal_code":"<string>"}'
```

### get_latest_articles

Get the latest published articles sorted by publication date descending, optionally filtered by journal.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `journal_code` | string | No | Optional journal short code to filter results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-royalsocietypublishing-org-api-949d587d/get_latest_articles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"journal_code":"<string>"}'
```

### list_issues_by_year

List all issues published in a given year for a journal. Returns volume number, issue number, URL, and date for each issue.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `journal_code` | string | Yes | Journal short code. |
| `year` | string | Yes | Four-digit year (e.g. 2024). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-royalsocietypublishing-org-api-949d587d/list_issues_by_year \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"journal_code":"<string>","year":"<string>"}'
```

### list_journals

Get the complete list of Royal Society journals with their short codes, names, and URLs. Returns all 11 journals in a single response.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-royalsocietypublishing-org-api-949d587d/list_journals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_articles

Full-text search across all Royal Society journals. Returns paginated results with title, authors, DOI, URL, and abstract excerpt.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `query` | string | No | Search query string. Use * for all articles. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-royalsocietypublishing-org-api-949d587d/search_articles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```