# Maradminbot — 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 retrieve official Marine Corps MARADMIN announcements from Marines.mil, filtering by year, status, and keyword to stay updated on the latest personnel and administrative directives. Get detailed information about specific announcements by number or browse the most recent updates to ensure you never miss critical Marine Corps guidance.

**Category:** Government & Public Data | **Website:** [maradminbot.com/](https://maradminbot.com/) | **Docs:** [parse.bot/marketplace/89be73b9-2212-4d32-9acf-432b7c60afad/maradminbot-com-api](https://parse.bot/marketplace/89be73b9-2212-4d32-9acf-432b7c60afad/maradminbot-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-maradminbot-com-api-89be73b9/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### filter_maradmins_by_status

Filter MARADMIN announcements by status. Returns announcements matching the specified status via server-side filtering.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `status` | string | No | Status to filter by. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-maradminbot-com-api-89be73b9/filter_maradmins_by_status \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":"<string>"}'
```

### filter_maradmins_by_year

Filter MARADMIN announcements by year. Returns all announcements published in the specified year via server-side filtering.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `year` | string | Yes | Four-digit year to filter by (e.g. '2025', '2026'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-maradminbot-com-api-89be73b9/filter_maradmins_by_year \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":"<string>"}'
```

### get_latest_maradmins

Retrieve the latest N MARADMIN announcements from the first page of the listing. A convenience endpoint that returns the most recent announcements without pagination.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return (up to 27, the page size). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-maradminbot-com-api-89be73b9/get_latest_maradmins \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### get_maradmin_by_number

Retrieve a specific MARADMIN by its number. Searches for the number and returns the full detail (title, date, body) of the matching announcement. If no exact match is found, returns the closest result.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `number` | string | Yes | MARADMIN number in format NNN/YY (e.g. '271/26', '055/26'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-maradminbot-com-api-89be73b9/get_maradmin_by_number \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"number":"<string>"}'
```

### get_maradmin_detail

Fetch the full text content and metadata of a specific MARADMIN announcement given its URL. The URL is typically obtained from list or search results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | The full URL of the MARADMIN article page on marines.mil (from list_maradmins or search_maradmins results). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-maradminbot-com-api-89be73b9/get_maradmin_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### list_maradmins

Retrieve a paginated list of MARADMIN announcements from the Marines.mil portal. Returns up to 27 items per page. Pagination advances by integer page number.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-maradminbot-com-api-89be73b9/list_maradmins \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### search_maradmins

Search for MARADMIN announcements by keyword. Performs a server-side keyword search against the Marines.mil MARADMIN listing and returns matching results. The search covers title and content fields.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g. 'promotion', 'drill instructor', or a MARADMIN number like '271/26'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-maradminbot-com-api-89be73b9/search_maradmins \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```