# Burdastyle — 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.

> Browse and search thousands of sewing patterns, access digital magazines and subscription details, and discover the latest blog posts from BurdaStyle all in one place. Filter patterns by category, view detailed instructions and materials for each design, and stay updated with curated content from the sewing community.

**Category:** E-commerce | **Website:** [burdastyle.com/](https://burdastyle.com/) | **Docs:** [parse.bot/marketplace/ba4adb5d-66b5-4e07-8db8-32618af3804b/burdastyle-com-api](https://parse.bot/marketplace/ba4adb5d-66b5-4e07-8db8-32618af3804b/burdastyle-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-burdastyle-com-api-ba4adb5d/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_blog_posts

Get recent blog posts from BurdaStyle. Returns post titles and URLs, paginated by page number.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |

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

### get_magazines_list

Get a paginated list of sewing magazine issues by brand. Returns magazine items with name, price, image, and URL. Currently only 'burda-style' is confirmed to return results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `brand` | string | No | Magazine brand slug. Confirmed working value: burda-style. |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-burdastyle-com-api-ba4adb5d/get_magazines_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"brand":"<string>","page":"<integer>"}'
```

### get_pattern_categories

Get the full taxonomy of sewing pattern categories and subcategories from the site navigation. Returns a hierarchy of categories each with name, URL, and nested subcategories array. No input required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-burdastyle-com-api-ba4adb5d/get_pattern_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_pattern_detail

Get full details of a single sewing pattern by its URL path or full URL. Returns structured product data including price, SKU, attributes (brand, difficulty level, sizes, issue), material consumption table, available PDF format types, and description. Requires a prior listing or search call to obtain the pattern URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL or path of the pattern page (e.g. https://www.burdastyle.com/cotton-top-102-burda-style-05-26-pdf-pattern or /cotton-top-102-burda-style-05-26-pdf-pattern). |

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

### get_patterns_list

Get a paginated list of sewing patterns by category. Supports filtering by difficulty level and sorting by newness, price, or name. Each page returns pattern items with name, price, image URL, and product URL. Pagination via page number; total_count reflects the full matching set.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category slug. |
| `level` | integer | No | Difficulty level filter (1-5). |
| `limit` | integer | No | Items per page. |
| `page` | integer | No | Page number for pagination. |
| `sort` | string | No | Sort order for results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-burdastyle-com-api-ba4adb5d/get_patterns_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","level":"<integer>","limit":"<integer>","page":"<integer>","sort":"<string>"}'
```

### get_subscriptions

Get available subscription plans from BurdaStyle. Returns plan names, descriptions, prices, URLs, and images. No pagination; returns all plans in one response.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-burdastyle-com-api-ba4adb5d/get_subscriptions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_patterns

Full-text search over all sewing patterns by keyword. Matches against pattern names and descriptions. Returns paginated results with pattern items and total count. Pagination via page number.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | Search keyword (e.g. dress, skirt, blouse). |

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