Magzter APImagzter.com ↗
Access Magzter's full catalog of magazines, newspapers, and articles. Search publications, browse issues, fetch article bodies, and retrieve category listings.
What is the Magzter API?
The Magzter API exposes 9 endpoints covering the full catalog of magazines, newspapers, and individual stories available on magzter.com. Use search_publications to find publications by keyword across the entire catalog, get_publication_issues to pull an archive of dated issues with cover images, or get_story_details to retrieve full article body text, author, publisher, and publication date for any story.
curl -X GET 'https://api.parse.bot/scraper/dddbddd3-be24-41d6-bb47-de690a401036/search_publications?page=0&query=technology' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace magzter-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Magzter SDK — browse publications, issues, and stories."""
from parse_apis.magzter_api import Magzter, Publication, Story, NotFoundError
magzter = Magzter()
# Search for technology publications — limit= caps total items fetched.
for pub in magzter.publications.search(query="technology", limit=5):
print(pub.mag_name, pub.country, pub.issue_price)
# Browse magazine catalog
for mag in magzter.publications.list_magazines(limit=3):
print(mag.mag_name, mag.pub_name, mag.slug)
# List available categories
for cat in magzter.categories.list(limit=5):
print(cat.name)
# Drill into a specific publication's issue archive
pub = magzter.publications.search(query="time", limit=1).first()
if pub:
for issue in pub.archive.list(limit=3):
print(issue.name, issue.date_published, issue.url)
# Get issue details from the archive
if pub:
issue = pub.archive.list(limit=1).first()
if issue:
detail = issue.details()
print(detail.in_this_issue)
print(detail.metadata.name, detail.metadata.publisher.name)
# Browse stories by category and get full article content
story = magzter.stories.by_category(category="Cover-Stories", section_id="sec_60", limit=1).first()
if story:
try:
full = story.details()
print(full.headline, full.date_published, full.author.name, full.article_body[:100])
except NotFoundError as exc:
print(f"Story not found: {exc}")
print("exercised: publications.search / list_magazines / categories.list / archive.list / issue.details / stories.by_category / story.details")
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.
| Param | Type | Description |
|---|---|---|
| page | integer | Zero-based page number for pagination. |
| queryrequired | string | Search keyword. |
{
"type": "object",
"fields": {
"hits": "array of publication objects matching the search query",
"page": "current zero-based page number",
"nbHits": "total number of matching results",
"nbPages": "total number of pages available"
},
"sample": {
"data": {
"hits": [
{
"Con": "United States",
"cat": [
"technology",
"news"
],
"lang": [
"english"
],
"slug": "US/MIT-Technology-Review/MIT-Technology-Review/Technology/",
"isGold": 1,
"magImg": "http://files.magzter.com/1728330124/1776870123/images/thumb/MITTechnologyReview_MayJune2026.jpg",
"magUrl": "https://www.magzter.com/US/MIT-Technology-Review/MIT-Technology-Review/Technology/",
"magName": "MIT Technology Review",
"pubName": "MIT Technology Review",
"issPrice": "9.99",
"objectID": "31319",
"oneYearPrice": "59.99",
"issuesPerYear": "6"
}
],
"page": 0,
"nbHits": 1214,
"nbPages": 41,
"hitsPerPage": 30
},
"status": "success"
}
}About the Magzter API
Catalog and Search
The search_publications endpoint accepts a query string and optional zero-based page parameter, returning an array of publication hits alongside nbHits (total matches) and nbPages for pagination. Separate endpoints — get_magazines_catalog and get_newspapers_catalog — let you page through the full magazine and newspaper catalogs independently, each returning the same paginated structure. get_categories returns a flat array of category name strings you can use to navigate the content tree.
Publication and Issue Data
get_publication_details accepts a slug (e.g. US/TIME-USA-LLC/Time/News/) and returns schema.org Periodical data: the canonical url, name, publisher organization object, and an offers array covering subscription and purchase options. get_publication_issues takes the same slug and returns an issues array where each element includes name, datePublished, url, and a cover image, plus an editorial description and the publication name at the root level.
Issue and Story Details
get_issue_details takes a full issue URL from the issues array and returns a metadata object with schema.org Periodical data scoped to that issue, plus an in_this_issue string summarizing the table of contents. For individual articles, get_story_details accepts a full story URL and returns headline, articleBody (full text), author, publisher, datePublished, and the story's originating publication context.
Stories by Category
get_stories_by_category accepts an optional category name and section_id to scope results, returning an itemListElement array of schema.org ListItem objects. Each item wraps an Article with headline, description, image, and url, making it straightforward to build category-scoped article feeds.
The Magzter API is a managed, monitored endpoint for magzter.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when magzter.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official magzter.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a magazine discovery tool that surfaces new publications by category using
get_categoriesandget_magazines_catalog. - Track issue publication cadence and cover changes for a set of titles using
get_publication_issuesand itsdatePublishedfield. - Aggregate full article text for NLP or summarization pipelines using the
articleBodyfield fromget_story_details. - Index Magzter's newspaper catalog for a media monitoring dashboard using
get_newspapers_catalog. - Compare subscription and purchase offer structures across publications using the
offersarray fromget_publication_details. - Build a content feed for a specific topic using
get_stories_by_categoryfiltered bycategoryandsection_id. - Populate a publication archive viewer with issue dates and cover images from
get_publication_issues.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Magzter have an official developer API?+
What does `get_publication_details` return beyond the publication name?+
get_publication_details returns the canonical url, a publisher object with organization details, and an offers array describing subscription and purchase options for that publication. It uses the publication slug (e.g. US/TIME-USA-LLC/Time/News/) as its only required input.Does the API expose reader reviews, ratings, or user-generated content for publications?+
How does pagination work across catalog endpoints?+
search_publications, get_magazines_catalog, and get_newspapers_catalog — use a zero-based page parameter. Each response includes page (current), nbHits (total results), and nbPages (total pages), so you can iterate through the full result set without guessing page counts.Does the API return paywall-restricted article content from premium publications?+
articleBody field in get_story_details returns text for stories accessible via the Magzter stories section. Full issue article content behind subscription paywalls is not exposed — the API covers issue metadata and table-of-contents summaries via in_this_issue for those. You can fork it on Parse and revise to add the missing endpoint if your use case requires broader content access.