# Maritime Executive — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 access maritime news articles, industry insights, and directory listings from The Maritime Executive, with the ability to browse by category, listen to podcasts, and read magazine editions. Find the latest maritime industry information, company directories, and multimedia content all in one place.

**Category:** News & Media | **Website:** [maritime-executive.com/](https://maritime-executive.com/) | **Docs:** [parse.bot/marketplace/a76573e8-4be9-4cbf-923f-027e1f41c930/maritime-executive-com-api](https://parse.bot/marketplace/a76573e8-4be9-4cbf-923f-027e1f41c930/maritime-executive-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/parse-maritime-executive-com-api-a76573e8/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### Get article

Fetch full article content and metadata by slug. Returns the article body, author, publication date, image, and other metadata. The slug is the last segment of an article URL path.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Article slug from the URL path (the last path segment of an article URL, e.g. 'atlantic-crossing-attempt-in-four-foot-boat-ends-in-rescue-off-newfoundland') or a full article URL. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-maritime-executive-com-api-a76573e8/get_article \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Get homepage

Fetch the homepage sections including Top Stories and Trending Stories. Returns two arrays of article summaries representing editorially curated content on the front page.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-maritime-executive-com-api-a76573e8/get_homepage \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get magazine editions

Get magazine editions from The Maritime Executive magazine archive. Returns a list of all editions with title (date range), URL, and cover thumbnail.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-maritime-executive-com-api-a76573e8/get_magazine_editions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get news by category

Get news articles for a specific category section. Returns paginated article listings for the given news category.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Category slug. Accepted values: piracy, shipbuilding, ports, shipping. |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-maritime-executive-com-api-a76573e8/get_news_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","page":"<integer>"}'
```

### Get podcasts

Get the latest podcast episodes from The Maritime Executive's In the Know podcast series. Returns all available podcast listings with title, URL, and thumbnail.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-maritime-executive-com-api-a76573e8/get_podcasts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search articles

Search for articles by keyword. Returns paginated results with article title, URL, and thumbnail. Use the page parameter to paginate through results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | Search keyword for finding articles. |

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

### Search directory

Search the maritime company directory by keyword. Returns matching company listings with name, address, website, and directory URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search query for the company directory. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-maritime-executive-com-api-a76573e8/search_directory \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```