maradminbot.com APImaradminbot.com ↗
Retrieve, search, and filter Marine Corps MARADMIN announcements from Marines.mil. 7 endpoints covering full text, metadata, year, status, and keyword search.
curl -X GET 'https://api.parse.bot/scraper/105bb9ef-c9e7-4982-971e-f2d3d803a75f/list_maradmins?page=1' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve a paginated list of MARADMIN announcements from the Marines.mil portal. Returns up to 27 items per page.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number to retrieve. |
{
"type": "object",
"fields": {
"page": "string, current page number",
"items": "array of MARADMIN summaries with number, title, date, status, and url"
},
"sample": {
"data": {
"page": "1",
"items": [
{
"url": "https://www.marines.mil/News/Messages/Messages-Display/Article/4479211/fy2026-55xx-primary-military-occupational-specialty-pmos-selection-board-results/",
"date": "5/7/2026",
"title": "FY2026 55XX PRIMARY MILITARY OCCUPATIONAL SPECIALTY (PMOS) SELECTION BOARD RESULTS",
"number": "213/26",
"status": "Active"
}
]
},
"status": "success"
}
}About the maradminbot.com API
The MarAdminBot API provides 7 endpoints for accessing Marine Corps MARADMIN announcements published on the Marines.mil portal. You can retrieve paginated listings via list_maradmins, fetch the full text and metadata of any announcement via get_maradmin_detail, or look up a specific directive by its number (e.g. 213/26) using get_maradmin_by_number. Each summary record includes the MARADMIN number, title, date, status, and a direct URL.
Browsing and Retrieving MARADMINs
list_maradmins returns a paginated list of MARADMIN summaries — up to 27 per page — each containing number, title, date, status, and url. Pass a page integer to walk through the archive. To pull only the most recent announcements without paginating, use get_latest_maradmins with a limit up to 27; it reads directly from the first page of the listing.
Detail and Number Lookup
get_maradmin_detail accepts a full Marines.mil article URL (typically sourced from a listing result's url field) and returns the complete announcement body along with title, date, and number. If you already know the MARADMIN number in NNN/YY format, get_maradmin_by_number runs the search internally and returns the same detail fields — body, date, title, number, and url — without requiring a separate lookup step.
Search and Filtering
search_maradmins accepts a free-text query — keywords like promotion or drill instructor, or a literal MARADMIN number — and returns matching summary records with the query echoed back in the response. For structured filtering, filter_maradmins_by_year accepts a four-digit year string and returns all announcements from that year, while filter_maradmins_by_status accepts Active, Cancelled, or Cancellation Notice as the status parameter and returns matching summaries.
Response Shape
Summary-level responses share a consistent shape across endpoints: number, title, date, status, and url. Detail endpoints extend this with a body field containing the full announcement text. The status field distinguishes between active directives and those that have been cancelled or issued a cancellation notice, which is useful for filtering out superseded guidance.
- Monitor newly published MARADMINs by polling
get_latest_maradminson a schedule and alerting on new entries - Build a search tool for Marines to look up directives by keyword using
search_maradminswith terms like 'promotion' or 'reenlistment' - Retrieve the full text of a known directive using
get_maradmin_by_numberwith a formatted number like '055/26' for automated parsing - Archive all MARADMINs from a specific year by iterating
filter_maradmins_by_yearwith values like '2024' or '2025' - Filter out cancelled directives from active policy feeds using
filter_maradmins_by_statuswith the 'Active' parameter - Cross-reference MARADMIN numbers extracted from other documents by resolving them to full detail via
get_maradmin_detail
| 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 | 250 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 Marines.mil have an official developer API for MARADMIN data?+
What does `filter_maradmins_by_status` return, and what status values are valid?+
number, title, date, status, and url — filtered to the status you specify. The three accepted values are Active, Cancelled, and Cancellation Notice. The status value you passed is also echoed back in the response.How many results does `list_maradmins` return per page?+
page integer parameter to advance through the archive. The response includes a page field confirming which page was returned.Does the API expose attachments, enclosures, or embedded references within MARADMIN announcements?+
get_maradmin_detail and get_maradmin_by_number endpoints return the full text body, title, date, number, and url, but do not surface linked enclosures or attachment files separately. You can fork this API on Parse and revise it to add an endpoint that parses attachment links from the body text.Can I filter MARADMINs by subject category or issuing authority?+
filter_maradmins_by_year), status (via filter_maradmins_by_status), and keyword search (via search_maradmins). Subject category or issuing authority are not exposed as filter parameters. You can fork this API on Parse and revise it to add category-based filtering if the source data includes that metadata.