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