poedb.tw APIpoedb.tw ↗
Access Path of Exile item stats, skill gems, passives, league info, and category listings for both PoE 1 and PoE 2 via the poedb.tw API.
curl -X GET 'https://api.parse.bot/scraper/9216ce94-1acd-456a-b0bb-9b2fa05ab44c/search?query=fireball&version=poe1' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for game entities (items, gems, passives, etc.) by keyword. Returns a list of matching labels and their corresponding URL slugs from the autocomplete index.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword to match against entity labels (case-insensitive substring match) |
| version | string | Game version: 'poe1' or 'poe2' |
{
"type": "object",
"fields": {
"results": "array of objects with label, value, desc, and class fields"
},
"sample": {
"data": {
"results": [
{
"desc": "Wiki",
"class": "",
"label": "Fireball",
"value": "Fireball"
},
{
"desc": "Wiki",
"class": "",
"label": "Vaal Fireball",
"value": "Vaal_Fireball"
}
]
},
"status": "success"
}
}About the poedb.tw API
The poedb.tw API exposes 4 endpoints covering Path of Exile game data across both PoE 1 and PoE 2, including item stats, skill gem details, passive nodes, and league history. The get_details endpoint returns structured sections with tables and text for any entity slug — items like Headhunter, skills like Fireball, or mechanics like Bleeding. The search endpoint lets you resolve entity names to slugs before fetching full records.
Searching and Resolving Entities
The search endpoint accepts a query string and an optional version parameter (poe1 or poe2) and returns an array of matching entities. Each result includes a label (display name), value (URL slug usable in get_details), desc (short description), and class (entity type such as gem, item, or passive). This is the primary way to discover slugs before fetching full records.
Entity Detail Pages
The get_details endpoint takes a slug — obtained from search results or known in advance — and returns the full structured page for that entity. The response includes the entity's name, canonical url, and a sections array. Each section has a title, one or more tables (row/column data for stats, modifiers, and level scaling), and optional text content. This covers items, gems, keystones, ailments, and other game objects.
Category Browsing
The get_category_data endpoint accepts a category string matching URL path segments used by poedb.tw — examples include Unique_item, Gem, League, Maps, and Bleeding. It returns a cards array where each card has a title and an items list with tabular properties for every entry in that category. This is useful for bulk lookups across an entire item class or mechanic type.
League Data
The get_leagues endpoint returns league information for PoE 1 or PoE 2 depending on the version parameter. The response is structured as cards, each containing a list of leagues with associated metadata such as name, duration, and dates. The category field in the response is always set to 'League'.
- Build a loot filter tool that resolves item names to full stat blocks using
searchthenget_details - Populate a league history timeline using
get_leaguesfor both PoE 1 and PoE 2 - Generate a reference sheet of all unique items by fetching the
Unique_itemcategory viaget_category_data - Look up skill gem level-scaling tables for a build planner using
get_detailswith a gem slug - Track all map tiers and properties for a mapping tool via the
Mapscategory endpoint - Resolve passive node descriptions and modifiers for a passive tree analyzer using
get_details - Compare ailment mechanics like Bleeding or Poison by fetching their category and detail pages
| 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 | 250 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 poedb.tw have an official developer API?+
What does the `get_details` endpoint return for a skill gem like Fireball?+
sections array where each section contains a title, tables with row-and-column data (e.g., level scaling, damage values, mana costs), and optional text content. The top-level response also includes the entity's display name and canonical url on poedb.tw.Can I filter `get_category_data` results by item base type or modifier?+
items arrays. You can fork this API on Parse and revise it to add a filter parameter that narrows results before returning them.Does the API expose Path of Exile trade prices or real-time economy data?+
Is pagination supported for large category responses?+
get_category_data endpoint returns all available cards for a category in a single response without pagination parameters. For very large categories, the full payload is returned at once. If you need paginated access, you can fork this API on Parse and revise it to add offset or page parameters.