# Magzter — 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 millions of magazines, newspapers, and stories from Magzter's digital library, then dive into specific publications, issues, and articles by category. Discover detailed information about any magazine or newspaper edition to find exactly what you want to read.

**Category:** News & Media | **Website:** [magzter.com/](https://magzter.com/) | **Docs:** [parse.bot/marketplace/7f64274f-1f87-4e9f-bcd1-aadb66bf026c/magzter-com-api](https://parse.bot/marketplace/7f64274f-1f87-4e9f-bcd1-aadb66bf026c/magzter-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-magzter-com-api-7f64274f/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_categories

Retrieve the full list of magazine categories available on Magzter. Returns a static list of category names used for browsing the catalog.

**Estimated cost:** Metered

_No parameters required._

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

### get_issue_details

Retrieve details for a specific issue, including publication metadata and table of contents summary. The issue URL is obtained from get_publication_issues results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `issue_url` | string | Yes | Full URL of the issue (e.g. 'https://www.magzter.com/US/TIME-USA-LLC/Time/News/2333727'). Available from get_publication_issues results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-magzter-com-api-7f64274f/get_issue_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"issue_url":"<string>"}'
```

### get_magazines_catalog

Retrieve a paginated list of all magazines from the Magzter catalog. Each page returns up to 30 magazines. Use zero-based page number for pagination.

**Estimated cost:** Metered

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

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

### get_newspapers_catalog

Retrieve a paginated list of newspapers available on Magzter. Each page returns up to 30 newspapers. Use zero-based page number for pagination.

**Estimated cost:** Metered

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

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

### get_publication_details

Retrieve full details for a specific magazine or newspaper publication using its catalog slug. Returns structured schema.org Periodical data including subscription offers, publisher info, and the latest issue metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Publication slug from the catalog (e.g. 'US/TIME-USA-LLC/Time/News/'). Available in search_publications or catalog results as the slug field. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-magzter-com-api-7f64274f/get_publication_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_publication_issues

Retrieve all available issues (archive) for a specific publication. Returns a list of issues with dates, cover images, and URLs for detail lookups.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Publication slug (e.g. 'US/TIME-USA-LLC/Time/News/'). Available in search_publications or catalog results as the slug field. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-magzter-com-api-7f64274f/get_publication_issues \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_stories_by_category

Retrieve stories organized by category. Returns a list of articles with headlines, descriptions, images, and URLs for detail lookups. Default category is Cover-Stories (sec_60).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Story category name used in the URL path. |
| `section_id` | string | No | Section ID for the category used in the URL path. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-magzter-com-api-7f64274f/get_stories_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","section_id":"<string>"}'
```

### get_story_details

Retrieve full content and metadata of a specific story/article including headline, author, publisher, article body text, and publication date. The story URL is obtained from get_stories_by_category results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `story_url` | string | Yes | Full URL of the story (e.g. 'https://www.magzter.com/stories/home/House-Beautiful-US/PAINTED-LADY'). Available from get_stories_by_category results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-magzter-com-api-7f64274f/get_story_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"story_url":"<string>"}'
```

### search_publications

Search for magazines, newspapers, and stories by keyword. Returns paginated results from the Magzter catalog including publication name, price, categories, country, and slug for detail lookups. Paginates via zero-based page number; each page returns up to 30 hits.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Zero-based page number for pagination. |
| `query` | string | Yes | Search keyword. |

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