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

> Access MDPI's open-access academic content programmatically. Search across thousands of peer-reviewed articles, retrieve full structured text, extract key findings, and browse journal metadata including impact factors and CiteScores.

**Category:** Education | **Website:** [mdpi.com/](https://mdpi.com/) | **Docs:** [parse.bot/marketplace/72eafbf4-79fd-4dc2-97f8-82802f8ed3f2/mdpi-com-api](https://parse.bot/marketplace/72eafbf4-79fd-4dc2-97f8-82802f8ed3f2/mdpi-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/mdpi/`
**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

### Extract plant names

Extract potential organism species names (binomial nomenclature) from italicized text in an MDPI article. Identifies names matching the pattern of a capitalized genus followed by a lowercase species epithet. Best suited for biology and ecology articles.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `path` | string | Yes | Article URL path in ISSN/volume/issue/article format (e.g. '/2223-7747/13/5/626'). |

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

### Get article details

Retrieve full details of an MDPI article by its URL path. Returns title, abstract, DOI, authors, journal name, and full-text body sections parsed from the article HTML. The path follows the ISSN/volume/issue/article_number format used in MDPI URLs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `path` | string | Yes | Article URL path in ISSN/volume/issue/article format (e.g. '/2223-7747/13/5/626'). |

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

### Get article full text sentences

Extract sentences from the full text of an MDPI article, optionally filtered by a keyword. Returns sentences from both abstract and body sections. Useful for building keyword-focused datasets from article content.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `keyword` | string | No | Keyword to filter sentences by (case-insensitive). Omitting returns all sentences. |
| `path` | string | Yes | Article URL path in ISSN/volume/issue/article format (e.g. '/2223-7747/13/5/626'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/mdpi/get-article-full-text-sentences \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"<string>","path":"<string>"}'
```

### Get article insights

Extract key findings, conclusions, and observations from an MDPI article by classifying body sections based on heading keywords (conclusion, result, discussion, etc.). Returns structured text grouped by insight type. Articles without matching section headings return empty arrays.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `path` | string | Yes | Article URL path in ISSN/volume/issue/article format (e.g. '/2223-7747/13/5/626'). |

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

### Get journal details

Retrieve detailed information for a specific MDPI journal by its slug. Returns journal metadata including ID, name, ISSN, impact factor, CiteScore, established year, quartile ranking, total articles, and navigation/social links.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Journal slug identifier (e.g. 'plants', 'sustainability', 'sensors'). |

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

### List all journals

List all MDPI journals with their ISSN, impact factor, and CiteScore. Returns the complete catalog of MDPI journals. Impact factor and CiteScore values are '-' when not yet assigned.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/mdpi/list-all-journals \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search articles

Full-text search over MDPI's open-access article catalog. Returns paginated article summaries with title, DOI, abstract, publication date, and journal name. Omitting the query returns recent articles across all journals. Results are ordered by relevance when a query is provided.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `query` | string | No | Search keyword or phrase. Omitting returns recent articles. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/mdpi/search-articles \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<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.