# Maritime Executive — 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 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.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.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.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.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.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.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.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.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>"}'
```