# Moneysavingexpert — 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 MoneySavingExpert's community forums for money-saving advice, browse discussions on mortgages, banking, and savings deals, and stay updated with the latest financial news and best buy recommendations. Access real-time deals and expert tips shared by the community to make informed decisions about your finances.

**Category:** Finance & Markets | **Website:** [moneysavingexpert.com/](https://moneysavingexpert.com/) | **Docs:** [parse.bot/marketplace/594bc1c3-4778-4e7c-9c8b-87db5b18915d/moneysavingexpert-com-api](https://parse.bot/marketplace/594bc1c3-4778-4e7c-9c8b-87db5b18915d/moneysavingexpert-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-moneysavingexpert-com-api-594bc1c3/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### Get banking deals

Fetches the latest discussions in the Banking & Budgeting forum category (category 20). Returns paginated results ordered by most recent activity.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max discussions per page. |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-moneysavingexpert-com-api-594bc1c3/get_banking_deals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>"}'
```

### Get category discussions

Fetches discussions for a specific forum category ID. Returns paginated results ordered by most recent activity. Each discussion includes its ID, title, body HTML, URL, category, date, comment count, and view count.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | integer | Yes | Forum category ID (e.g. 11 for Credit Cards, 15 for Mortgages, 17 for Savings, 20 for Banking). |
| `limit` | integer | No | Max discussions per page. |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-moneysavingexpert-com-api-594bc1c3/get_category_discussions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<integer>","limit":"<integer>","page":"<integer>"}'
```

### Get discussion details

Fetches details and comments for a specific forum discussion by ID. Returns the discussion metadata (title, body, URL, category, dates, counts) and up to 50 comments with their author name, body, and date.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `discussion_id` | integer | Yes | Discussion ID from search or category listing results. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-moneysavingexpert-com-api-594bc1c3/get_discussion_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"discussion_id":"<integer>"}'
```

### Get forum categories

Lists all forum categories with descriptions and stats. Each category has a unique categoryID, name, description, URL, and counts of discussions and comments. Returns a flat list of all categories regardless of hierarchy depth.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max categories per page. |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-moneysavingexpert-com-api-594bc1c3/get_forum_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>"}'
```

### Get latest news

Fetches the latest discussions from the MSE News & Blogs forum category (category 52). Returns paginated results including Martin Lewis blog discussions and MSE news.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max results per page. |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-moneysavingexpert-com-api-594bc1c3/get_latest_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>"}'
```

### Get main site page

Fetches a page from the main MoneySavingExpert site and returns the final resolved URL and raw HTML content. Useful for accessing editorial content, guides, and tool pages outside the forum.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `path` | string | No | URL path to fetch (e.g. '/', '/savings/', '/mortgages/best-buys/'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-moneysavingexpert-com-api-594bc1c3/get_main_site_page \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"path":"<string>"}'
```

### Get mortgage best buys

Fetches the latest discussions in the Mortgages & Endowments forum category (category 15). Returns paginated results ordered by most recent activity.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max discussions per page. |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-moneysavingexpert-com-api-594bc1c3/get_mortgage_best_buys \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>"}'
```

### Get savings deals

Fetches the latest discussions in the Savings & Investments forum category (category 17). Returns paginated results ordered by most recent activity.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max discussions per page. |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-moneysavingexpert-com-api-594bc1c3/get_savings_deals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>"}'
```

### Search forum

Searches the forum for discussions matching specific keywords. Returns paginated results across all categories. Each result includes discussion ID, title, body excerpt, URL, category ID, date, and comment count.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max results per page. |
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | Search keyword or phrase. |

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