Path of Exile APIpathofexile.com ↗
Fetch the latest Path of Exile news and announcements via API. Returns titles, links, dates, descriptions, and categories from the official feed.
What is the Path of Exile API?
The Path of Exile News API exposes 1 endpoint — get_latest_news — that returns up to 28 articles from the official Path of Exile news feed. Each article object includes 5 fields: title, link, published_date, description, and category, delivered in reverse chronological order. It covers game updates, patch notes, event announcements, and community alerts as they appear on pathofexile.com.
curl -X GET 'https://api.parse.bot/scraper/5e9a0d00-c9a9-4c30-b023-a5547cef3312/get_latest_news?limit=5' \ -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 pathofexile-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: Path of Exile News API — fetch latest game announcements."""
from parse_apis.pathofexile_com_api import PathOfExile, ParseError
client = PathOfExile()
# List the latest 5 news articles
for article in client.articles.list(limit=5):
print(article.title, "|", article.link)
# Grab the most recent article and inspect its fields
latest = client.articles.list(limit=1).first()
if latest:
try:
print(f"Title: {latest.title}")
print(f"Published: {latest.published_date}")
print(f"Category: {latest.category}")
print(f"Link: {latest.link}")
except ParseError as exc:
print(f"Parse error: {exc}")
print("exercised: articles.list")
Fetch the latest news articles from Path of Exile. Returns articles in reverse chronological order with title, link, publication date, description, and category. Results are sourced from the official RSS feed and auto-iterated as a single page.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of articles to return. The RSS feed contains up to ~28 articles. |
{
"type": "object",
"fields": {
"articles": "array of news article objects with title, link, published_date, description, category",
"total_returned": "integer count of articles returned"
},
"sample": {
"data": {
"articles": [
{
"link": "https://www.pathofexile.com/forum/view-thread/3968867",
"title": "Play the Return of the Ancestors Event on June 25th PDT",
"category": "news",
"description": "The Ancestors have heard your call...",
"published_date": "Fri, 19 Jun 2026 21:00:00 +0000"
}
],
"total_returned": 5
},
"status": "success"
}
}About the Path of Exile API
What the API Returns
The get_latest_news endpoint returns an array of news article objects sourced from the official Path of Exile RSS feed. Each object in the articles array includes a title (the article headline), a link (direct URL to the full article on pathofexile.com), a published_date (ISO-formatted timestamp), a description (article summary or excerpt), and a category label such as "Announcements" or "Patch Notes". The response also includes a total_returned integer so you can confirm how many articles were fetched.
Filtering Results
The single optional input parameter limit controls how many articles are returned, capped at the feed's natural size of approximately 28 articles. Passing limit=5 will return the five most recent articles; omitting it returns the full available set. Results are always ordered newest-first, so index 0 is always the latest published item.
Coverage and Freshness
The feed reflects the most recently published official content on pathofexile.com, including league announcements, patch notes, balance manifests, and scheduled event notices. Because the source is the official RSS feed, articles appear here roughly in step with when Grinding Gear Games publishes them on the site. There is no historical archive beyond what the feed currently exposes, which is typically the last 28 articles.
The Path of Exile API is a managed, monitored endpoint for pathofexile.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when pathofexile.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 pathofexile.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?+
- Display the latest patch notes and balance changes in a game companion app using the
titleandlinkfields. - Trigger Discord or Slack bot notifications whenever a new article's
published_dateis newer than the last cached entry. - Filter articles by
categoryto surface only league-start announcements to users who opt out of minor update noise. - Build a lightweight news feed widget for a Path of Exile fan site using
title,description, andpublished_date. - Monitor official event schedules by parsing
descriptiontext from articles categorized under events or announcements. - Archive the last 28 articles periodically to maintain a local history beyond the rolling RSS window.
| 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 Path of Exile have an official developer API?+
What does the `category` field actually contain?+
category field reflects the tag assigned to the article in the official RSS feed, such as "Announcements", "Patch Notes", or "Events". Not every article carries a category; the field may be empty or null for uncategorized entries.How far back does the news history go?+
Can I retrieve trade listings or item prices through this API?+
title, link, published_date, description, and category. Trade search results, item prices, and currency exchange rates are not included. You can fork this API on Parse and revise it to add an endpoint targeting trade or economy data.Does the API return the full article body text?+
description field contains the article excerpt or summary as it appears in the feed, not the complete article body. The link field points to the full article on pathofexile.com. You can fork this API on Parse and revise it to add a detail endpoint that fetches the full article content by URL.