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

> 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/magzter/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/magzter/get-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/magzter/get-issue-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/magzter/get-magazines-catalog \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/magzter/get-newspapers-catalog \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/magzter/get-publication-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/magzter/get-publication-issues \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/magzter/get-stories-by-category \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/magzter/get-story-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/magzter/search-publications \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.