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

## Access

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

## 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/parse-mdpi-com-api-72eafbf4/extract_plant_names \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-mdpi-com-api-72eafbf4/get_article_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-mdpi-com-api-72eafbf4/get_article_full_text_sentences \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-mdpi-com-api-72eafbf4/get_article_insights \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-mdpi-com-api-72eafbf4/get_journal_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-mdpi-com-api-72eafbf4/list_all_journals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-mdpi-com-api-72eafbf4/search_articles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```