poe.ninja API: get_item_prices
poe.ninja via Parse · entertainment
Retrieve current prices of Path of Exile items from poe.ninja for a given league and item category. Returns items with chaos orb and divine orb valuations, base types, link counts, and item classes. When category is SkillGem, each item also includes gem_level, gem_quality, and corrupted fields, and results can be filtered by gem level and/or gem quality using either single values or multiple combinations via gem_combinations, and by corruption status via the corrupted parameter. Quality 0 matches gems with no explicit quality set. Categories that no longer exist on poe.ninja (e.g. DivinationCard) return an upstream 404. API to extract Path of Exile economic and build data from poe.ninja. Includes item prices, currency rates, market trends, and build statistics. Fulfilled by Parse from poe.ninja.
- entertainment
- finance
- marketplace
- parse
- platform-key
- poe-ninja
Price and execution
- Price
- $0.04 USD credits / call
- Trust tier
- Verified
- Execution
- Managed call
- Capability group
- entertainment
Interface snapshot
- Protocol
- HTTP operation
- Operation
- GET /scraper/d24b0bde-6a4c-44a4-82b3-3eb42f9e3d0c/get_item_prices
- Interface artifact
- sha256:73ab072d37325e9c36f85f03476fc8dc77f16e541440293ab0d2527590d319fc
- Manifest digest
- sha256:26711d676bb4bd0a9196281ec0ce13911e6d8b82650a3afcfa0eb0d1fa721454
Request fields
- league (string): League name. Active economy leagues include Mirage, Hardcore Mirage, Standard, Hardcore, Allflame, Hardcore Allflame.: Allowed values: Mirage, Hardcore Mirage, Standard, Hardcore, Allflame, Hardcore Allflame
- category (string): Item category. Accepted values include UniqueWeapon, UniqueArmour, UniqueAccessory, UniqueFlask, UniqueJewel, SkillGem, Map, Incubator.: Allowed values: UniqueWeapon, UniqueArmour, UniqueAccessory, UniqueFlask, UniqueJewel, SkillGem, Map, Incubator
- corrupted (boolean): Filter by corruption status when category is SkillGem. When true, returns only corrupted gems; when false, returns only non-corrupted gems. Omit to return both. Ignored for non-SkillGem categories.
- gem_level (integer): Filter by gem level when category is SkillGem (e.g. 21). Ignored for non-gem categories. Overridden by gem_combinations when both are provided.
- gem_quality (integer): Filter by gem quality when category is SkillGem (e.g. 20). Use 0 for gems with no explicit quality. Ignored for non-gem categories. Overridden by gem_combinations when both are provided.
- gem_combinations (string): JSON array of objects specifying multiple gem level/quality filter combinations when category is SkillGem. Each object may have 'level' and/or 'quality' keys (e.g. [{"level": 21, "quality": 20}, {"level": 20, "quality": 0}]). Items matching ANY combination are returned. Use quality 0 for gems with no explicit quality. Takes precedence over gem_level/gem_quality when provided. Ignored for non-gem categories.
Example queries
- {"league":"Mirage","category":"UniqueWeapon","corrupted":"true","gem_level":"21","gem_quality":"20","gem_combinations":"[{\"level\": 21, \"quality\": 20}, {\"level\": 20, \"quality\": 0}]"}