Maritime Executive APImaritime-executive.com ↗
Access maritime news, articles, company directory listings, podcasts, and magazine editions from The Maritime Executive via 7 structured API endpoints.
What is the Maritime Executive API?
The Maritime Executive API exposes 7 endpoints covering industry news, company directory search, podcasts, and magazine archive data from maritimeexecutive.com. The get_article endpoint returns full article body text, author, publication date, main image URL, and a plain-text description, while search_articles and get_news_by_category let you pull paginated article listings by keyword or topic. A company directory search endpoint returns name, address, and website for maritime businesses.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/6433b974-5aeb-4be8-8623-a1c25d4c15ea/get_homepage' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace maritime-executive-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Maritime Executive API — search articles, drill into details, browse by category."""
from parse_apis.the_maritime_executive_api import MaritimeExecutive, Category, ArticleNotFound
client = MaritimeExecutive()
# Search for shipping articles, take the first result
article_summary = client.articlesummaries.search(query="shipping", limit=3).first()
if article_summary:
print(article_summary.title, article_summary.url)
# Drill into the full article from a summary
if article_summary:
try:
full_article = article_summary.details()
print(full_article.title, full_article.author, full_article.date_published)
except ArticleNotFound as exc:
print(f"Article gone: {exc}")
# Browse piracy category news
for item in client.articlesummaries.by_category(category=Category.PIRACY, limit=3):
print(item.title, item.thumbnail)
# List latest podcasts
for podcast in client.podcasts.list(limit=3):
print(podcast.title, podcast.url)
# List magazine editions
for edition in client.editions.list(limit=3):
print(edition.title, edition.url)
# Get the homepage curated content
homepage = client.homepages.get()
print(f"Top stories: {len(homepage.top_stories)}, Trending: {len(homepage.trending_stories)}")
print("Exercised: articlesummaries.search / details / by_category / podcasts.list / editions.list / homepages.get")
Fetch the homepage sections including Top Stories and Trending Stories. Returns two arrays of article summaries representing editorially curated content on the front page.
No input parameters required.
{
"type": "object",
"fields": {
"top_stories": "array of article objects with title, url, and thumbnail",
"trending_stories": "array of article objects with title, url, and thumbnail"
},
"sample": {
"data": {
"top_stories": [
{
"url": "https://maritime-executive.com/article/atlantic-crossing-attempt-in-four-foot-boat-ends-in-rescue-off-newfoundland",
"title": "Atlantic Crossing Attempt in Four-Foot Boat Ends in Rescue off Newfoundland",
"thumbnail": "https://maritime-executive.com/media/images/article/Big-C-V2-June-4-2026-shortest-boat-Andrew-Bedwell.df8af7.jpg"
}
],
"trending_stories": [
{
"url": "https://maritime-executive.com/article/four-indian-seafarers-rescued-from-abandoned-ship-after-10-months",
"title": "Four Indian Seafarers Rescued from Abandoned Ship After 10 Months",
"thumbnail": "https://maritime-executive.com/media/images/article/Settebello-attack.24a6aa.jpg"
}
]
},
"status": "success"
}
}About the Maritime Executive API
Articles and News Coverage
The get_article endpoint accepts an article slug — the final path segment of any article URL — and returns eight fields: title, body, author, date_published (ISO 8601), description, image, url, and publisher. The search_articles endpoint accepts a query string and optional page integer, returning an array of results with title, url, and thumbnail per item, plus a has_next boolean for pagination control. get_homepage returns two curated arrays — top_stories and trending_stories — with no parameters required.
Category and Directory Browsing
The get_news_by_category endpoint filters articles by category slug. Accepted values are piracy, shipbuilding, ports, and shipping. Results are paginated with page and has_next fields returned alongside the articles array. The search_directory endpoint queries the maritime company directory and returns a companies array where each entry includes name, url, address, and website.
Podcasts and Magazine Archive
The get_podcasts endpoint returns all available episodes from The Maritime Executive's "In the Know" podcast series as an array of objects with title, url, and thumbnail. The get_magazine_editions endpoint returns the full magazine archive as an editions array, each with a title (date range string), url, and cover thumbnail. Neither endpoint accepts parameters.
The Maritime Executive API is a managed, monitored endpoint for maritime-executive.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when maritime-executive.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official maritime-executive.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Monitor piracy or shipbuilding news feeds using
get_news_by_categorywith relevant category slugs. - Build a maritime company lookup tool using
search_directoryto surface address and website by firm name. - Aggregate full article text from
get_articlefor NLP analysis of maritime industry trends. - Track editorial trending content with
get_homepageto surface what The Maritime Executive is currently featuring. - Index podcast episodes from the 'In the Know' series via
get_podcastsfor a maritime audio aggregator. - Archive or display historical magazine covers and edition metadata using
get_magazine_editions. - Keyword-search maritime topics across the publication's full article history via
search_articles.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does The Maritime Executive offer an official developer API?+
What does `get_news_by_category` return, and which categories are supported?+
title, url, and thumbnail — plus the category string, current page, and a has_next boolean. The four accepted category slugs are piracy, shipbuilding, ports, and shipping. Other section names from the site are not currently mapped as category values.Does the article endpoint return author social profiles, tags, or related articles?+
get_article endpoint returns author as a plain name string. It does not currently return social profile links, content tags, or related article arrays. The API covers the core metadata fields: title, body, image, author, publisher, description, date_published, and url. You can fork this API on Parse and revise it to add tag or related-article fields.Is there a way to retrieve all articles in a date range or sort by publication date?+
search_articles endpoint filters by keyword and supports page-based pagination, but does not accept date range or sort parameters. get_news_by_category similarly paginates without date filtering. You can fork this API on Parse and revise it to add date-range filtering as an endpoint parameter.How does pagination work across endpoints that support it?+
search_articles and get_news_by_category accept an optional page integer (defaults to the first page when omitted) and return a has_next boolean in the response. When has_next is true, increment page by one to retrieve the next batch. The response also echoes back the current page value so you can track position without maintaining external state.