{"openapi":"3.1.0","info":{"title":"Path of Exile API","version":"1.0.0","description":"Path of Exile game reference data as an API, straight from Grinding Gear Games' public endpoints. List the current leagues (Standard, Hardcore, the temporary challenge league and their Solo-Self-Found and Ruthless variants) with their rules and dates. Browse the full item catalogue — every base type and unique item across Accessories, Armour, Weapons, Gems, Currency, Divination Cards, Flasks, Jewels and Maps — search it by name and filter to uniques only or to a category, or look up a single item. List the item categories with counts, and search the trade modifier-stat dictionary (the affixes you can search for in trade) by text. Real game data, no key needed upstream. Ideal for trade and crafting tools, loot filters, build planners and Path of Exile fan sites.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/poe-api","description":"oanor gateway"}],"tags":[{"name":"Path of Exile"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/categories":{"get":{"operationId":"get_v1_categories","tags":["Path of Exile"],"summary":"Item categories with counts","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":20,"categories":[{"name":"Accessories","items":382},{"name":"Armour","items":1036},{"name":"Cards","items":464},{"name":"Currency","items":666},{"name":"Flasks","items":86},{"name":"Gems","items":860},{"name":"Jewels","items":201},{"name":"Maps","items":615},{"name":"Weapons","items":711},{"name":"Leaguestones","items":16},{"name":"Itemised Monsters","items":358},{"name":"Heist Equipment","items":56},{"name":"Heist Mission","items":28},{"name":"Expedition Logbooks","items":1},{"name":"Sanctum","items":22},{"name":"Tincture","items":15},{"name":"Itemised Corpse","items":102},{"name":"Idol","items":45},{"name":"Graft","items":17},{"name":"Wombgift","items":5}]},"meta":{"timestamp":"2026-06-08T01:18:24.777Z","request_id":"dfb26f24-3931-490b-be34-4822ee658159"},"status":"ok","message":"Categories retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/item":{"get":{"operationId":"get_v1_item","tags":["Path of Exile"],"summary":"A single item by name","description":"","parameters":[{"name":"name","in":"query","required":true,"description":"Item name, e.g. Headhunter","schema":{"type":"string"},"example":"Headhunter"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"item":{"name":"Headhunter","type":"Leather Belt","unique":true,"category":"Accessories","prophecy":false}},"meta":{"timestamp":"2026-06-08T01:18:24.874Z","request_id":"740befac-d163-46a4-ab2c-1314d39c2dd9"},"status":"ok","message":"Item retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/items":{"get":{"operationId":"get_v1_items","tags":["Path of Exile"],"summary":"Search & filter the item catalogue","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Name contains, e.g. tabula","schema":{"type":"string"},"example":"tabula"},{"name":"category","in":"query","required":false,"description":"Category, e.g. Armour","schema":{"type":"string"}},{"name":"unique","in":"query","required":false,"description":"Set 1 for unique items only","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (default 50, max 300)","schema":{"type":"string"},"example":"50"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":1,"items":[{"name":"Tabula Rasa","type":"Simple Robe","unique":true,"category":"Armour","prophecy":false}],"total":1},"meta":{"timestamp":"2026-06-08T01:18:24.968Z","request_id":"7d3a9d46-22fb-4de0-b016-050c745f52b9"},"status":"ok","message":"Items retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/leagues":{"get":{"operationId":"get_v1_leagues","tags":["Path of Exile"],"summary":"Current leagues","description":"","parameters":[{"name":"realm","in":"query","required":false,"description":"pc | xbox | sony","schema":{"type":"string"},"example":"pc"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":16,"realm":"pc","leagues":[{"id":"Standard","realm":"pc","rules":[],"starts_at":"2013-01-23T21:00:00Z","description":"The default game mode."},{"id":"Hardcore","realm":"pc","rules":["Hardcore"],"starts_at":"2013-01-23T21:00:00Z","description":"A character killed in the Hardcore league is moved to the Standard league."},{"id":"Solo Self-Found","realm":"pc","rules":["Solo"],"starts_at":"2013-01-23T21:00:00Z","description":"SSF Standard"},{"id":"Hardcore SSF","realm":"pc","rules":["Hardcore","Solo"],"starts_at":"2013-01-23T21:00:00Z","description":"SSF Hardcore"},{"id":"Ruthless","realm":"pc","rules":["Ruthless"],"description":"Ruthless"},{"id":"Hardcore Ruthless","realm":"pc","rules":["Hardcore","Ruthless"],"description":"Hardcore Ruthless"},{"id":"SSF Ruthless","realm":"pc","rules":["Solo","Ruthless"],"description":"SSF Ruthless"},{"id":"Hardcore SSF Ruthless","realm":"pc","rules":["Hardcore","Solo","Ruthless"],"description":"Hardcore SSF Ruthless"},{"id":"Mirage","realm":"pc","rules":[],"starts_at":"2026-03-06T19:00:00Z","description":"Wish for the Wraeclast that could have been."},{"id":"Hardcore Mirage","realm":"pc","rules":["Hardcore"],"starts_at":"2026-03-06T19:00:00Z","description":"Wish for the Wraeclast that could have been.\n\nA character killed in Hardcore Mirage is moved to Mirage League."},{"id":"SSF Mirage","realm":"pc","rules":["Solo"],"starts_at":"2026-03-06T19:00:00Z","description":"SSF Mirage"},{"id":"HC SSF Mirage","realm":"pc","rules":["Hardcore","Solo"],"starts_at":"2026-03-06T19:00:00Z","description":"SSF HC Mirage"},{"id":"Ruthless Mirage","realm":"pc","rules":["Ruthless"],"starts_at":"2026-03-06T19:00:00Z","description":"Wish for the Wraeclast that could have been."},{"id":"HC Ruthless Mirage","realm":"pc","rules":["Hardcore","Ruthless"],"starts_at":"2026-03-06T19:00:00Z","description":"Wish for the Wraeclast that could have been.\n\nA character killed in Hardcore Mirage is moved to Mirage League."},{"id":"SSF R Mirage","realm":"pc","rules":["Solo","Ruthless"],"starts_at":"2026-03-06T19:00:00Z","description":"SSF Mirage"},{"id":"HC SSF R Mirage","realm":"pc","rules":["Hardcore","Solo","Ruthless"],"starts_at":"2026-03-06T19:00:00Z","description":"SSF HC Mirage"}]},"meta":{"timestamp":"2026-06-08T01:18:25.327Z","request_id":"c6522c8c-d059-47fe-927b-97cb617900b6"},"status":"ok","message":"Leagues retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/stats":{"get":{"operationId":"get_v1_stats","tags":["Path of Exile"],"summary":"Search modifier stats","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Stat text, e.g. maximum life","schema":{"type":"string"},"example":"maximum life"},{"name":"type","in":"query","required":false,"description":"Pseudo | Explicit | Implicit | …","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (default 50)","schema":{"type":"string"},"example":"50"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":50,"stats":[{"id":"pseudo.pseudo_total_life","text":"+# total maximum Life","type":"Pseudo"},{"id":"explicit.stat_3299347043","text":"+# to maximum Life","type":"Explicit"},{"id":"explicit.stat_983749596","text":"#% increased maximum Life","type":"Explicit"},{"id":"explicit.stat_770672621","text":"Minions have #% increased maximum Life","type":"Explicit"},{"id":"explicit.stat_3819827377","text":"Added Small Passive Skills also grant: +# to Maximum Life","type":"Explicit"},{"id":"explicit.stat_2887760183","text":"Monsters gain #% of Maximum Life as Extra Maximum Energy Shield","type":"Explicit"},{"id":"explicit.stat_1776945532","text":"Enemies you Kill have a #% chance to Explode, dealing a quarter of their maximum Life as Chaos Damage","type":"Explicit"},{"id":"explicit.stat_2301696196","text":"You take #% of your maximum Life as Chaos Damage on use","type":"Explicit"},{"id":"explicit.stat_3232201443","text":"#% of Maximum Life taken as Chaos Damage per second","type":"Explicit"},{"id":"explicit.stat_688802590","text":"Your Minions spread Caustic Ground on Death, dealing #% of their maximum Life as Chaos Damage per second","type":"Explicit"},{"id":"explicit.stat_67280387","text":"Gain #% of Maximum Life as Extra Maximum Energy Shield","type":"Explicit"},{"id":"explicit.stat_3899352861","text":"#% increased maximum Life, Mana and Global Energy Shield","type":"Explicit"},{"id":"explicit.stat_2458962764","text":"#% of Maximum Life Converted to Energy Shield","type":"Explicit"},{"id":"explicit.stat_1723061251","text":"Totems Reflect #% of their maximum Life as Fire Damage to nearby Enemies when Hit","type":"Explicit"},{"id":"explicit.stat_2912438397","text":"Summoned Skeletons take #% of their Maximum Life per second as Fire Damage","type":"Explicit"},{"id":"explicit.stat_3484267929","text":"Nearby allies Recover #% of your Maximum Life when you Die","type":"Explicit"},{"id":"explicit.stat_4116579804","text":"Raised Zombies have +# to maximum Life","type":"Explicit"},{"id":"explicit.stat_1114351662","text":"+# to Maximum Life per 10 Intelligence","type":"Explicit"},{"id":"explicit.stat_3133323410","text":"Bleeding Enemies you Kill Explode, dealing #% of\ntheir Maximum Life as Physical Damage","type":"Explicit"},{"id":"explicit.stat_927817294","text":"Raised Zombies have #% increased maximum Life","type":"Explicit"},{"id":"explicit.stat_3111456397","text":"+# to Spectre maximum Life","type":"Explicit"},{"id":"explicit.stat_3849523464","text":"+# to Maximum Life per Elder Item Equipped","type":"Explicit"},{"id":"explicit.stat_2217962305","text":"#% increased Maximum Life if no Equipped Items are Corrupted","type":"Explicit"},{"id":"explicit.stat_1750735210","text":"Golems have #% increased Maximum Life","type":"Explicit"},{"id":"explicit.stat_2865989731","text":"Adds 1 to Maximum Life per # Intelligence Allocated in Radius","type":"Explicit"},{"id":"explicit.stat_2937093415","text":"Enemies Taunted by your Warcries have #% chance to Explode on death, dealing 8% of their maximum Life as Chaos Damage","type":"Explicit"},{"id":"explicit.stat_3999870307","text":"Summoned Raging Spirits have #% increased maximum Life","type":"Explicit"},{"id":"explicit.stat_3775574601","text":"#% increased Spell Critical Strike Chance per 100 Player Maximum Life","type":"Explicit"},{"id":"explicit.stat_3491815140","text":"#% increased Spell Damage per 100 Player Maximum Life","type":"Explicit"},{"id":"explicit.stat_2290031712","text":"Strength provides no bonus to Maximum Life","type":"Explicit"},{"id":"explicit.stat_1960869129","text":"When a nearby Minion dies, gain Rotten Bulwark equal to #% of its maximum Life","type":"Explicit"},{"id":"explicit.stat_3035514623","text":"Raised Spectres have #% increased maximum Life","type":"Explicit"},{"id":"explicit.stat_1063920218","text":"Summoned Raging Spirits take #% of their Maximum Life per second as Chaos Damage","type":"Explicit"},{"id":"explicit.stat_4210076836","text":"+# to Maximum Life per Red Socket","type":"Explicit"},{"id":"explicit.stat_433536969","text":"Minions Convert #% of their Maximum Life to Maximum Energy\nShield per 1% Chaos Resistance they have","type":"Explicit"},{"id":"explicit.stat_726359715","text":"+# to maximum Life for each Empty Red Socket on any Equipped Item","type":"Explicit"},{"id":"explicit.stat_1982144275","text":"+# Maximum Life per Level","type":"Explicit"},{"id":"explicit.stat_3185671537","text":"#% increased Maximum Life per Abyss Jewel affecting you","type":"Explicit"},{"id":"explicit.stat_3018691556","text":"#% increased maximum Life and reduced Fire Resistance","type":"Explicit"},{"id":"explicit.stat_1199118714","text":"Socketed Golem Skills gain #% of Maximum Life as Extra Maximum Energy Shield","type":"Explicit"},{"id":"explicit.stat_2783958145","text":"#% more Maximum Life","type":"Explicit"},{"id":"explicit.stat_3806100539","text":"+# to Maximum Life per 10 Dexterity","type":"Explicit"},{"id":"explicit.stat_2927667525","text":"+# to maximum Life if there are no Life Modifiers on other Equipped Items","type":"Explicit"},{"id":"explicit.stat_2165415361","text":"Enemies you Kill during Effect have a #% chance to Explode, dealing a tenth of their maximum Life as Damage of a Random Element","type":"Explicit"},{"id":"explicit.stat_3295179224","text":"Enemies you Kill have a #% chance to Explode, dealing a tenth of their maximum Life as Physical Damage","type":"Explicit"},{"id":"explicit.stat_2442112158","text":"While in Her Embrace, take #% of your total Maximum Life and Energy Shield as Fire Damage per second per Level","type":"Explicit"},{"id":"explicit.stat_4053338379","text":"Your Maximum Energy Shield is Equal to #% of Your Maximum Life","type":"Explicit"},{"id":"explicit.stat_3637775205","text":"+# to Evasion Rating per 10 Player Maximum Life","type":"Explicit"},{"id":"explicit.stat_370215510","text":"#% increased maximum Life if 2 Elder Items are Equipped","type":"Explicit"},{"id":"explicit.stat_586568910","text":"Corpses you Spawn have #% increased Maximum Life","type":"Explicit"}],"total":193},"meta":{"timestamp":"2026-06-08T01:18:25.438Z","request_id":"21205a7a-4615-462c-8516-6f707a24a2bb"},"status":"ok","message":"Stats retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service description & endpoints","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"service":"poe-api","endpoints":{"GET /v1/item":"A single item by name (name=).","GET /v1/meta":"This document.","GET /v1/items":"Search/filter the item catalogue (q=, category=, unique=1, limit=).","GET /v1/stats":"Search modifier stats (q=, type=, limit=).","GET /v1/leagues":"Current leagues (realm=pc|xbox|sony).","GET /v1/categories":"Item categories with counts."},"description":"Path of Exile game reference data via Grinding Gear Games' public APIs: the current leagues; the full item catalogue (base types and unique items across Accessories, Armour, Weapons, Gems, Currency, Divination Cards, Maps and more); the item categories; and the trade modifier-stat dictionary. Real data, no key."},"meta":{"timestamp":"2026-06-08T01:18:25.487Z","request_id":"02e3e994-e8eb-484a-9058-ad86c08ad3a7"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":10600,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":340,"monthly_call_quota":144000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1580,"monthly_call_quota":745000,"rps_limit":25,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":5750,"monthly_call_quota":3440000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/poe-api"}