pf2e-compendium-filter-items
Search COMPENDIUM packs for items with Pathfinder 2e structured filters (pf2e worlds only): equipment, spells, feats, ancestries, classes and 20 more Item types.
CRITICAL DATA FORMATS
For spells, level is the spell RANK.
traits are ALL-OF (every trait present); traditions are ANY-OF (arcane, divine, occult, primal). Do not confuse the two.
category is the feat category (class, skill, general, ancestry, ...). rarity: common, uncommon, rare, unique.
priceGold is gp with decimals (5 sp -> 0.5), per batch for batched goods like arrows.
SEMANTICS: filters combine with AND, values inside one array with OR. Ranges are {min?, max?}, inclusive (min = max for exact). Documents lacking a filtered field are silently excluded. limit 1..200 (default 50), offset; the response has total and hasMore. Results are {name, uuid} entries: follow up with uuid-resolve, or compendium-browse with ids to batch-load. Requires bridge module 8.11.0+. Results carry level (null when absent), sorted by level then name.
EXAMPLES { "type": ["spell"], "level": { "min": 3, "max": 3 }, "traditions": ["arcane"] } { "type": ["consumable"], "priceGold": { "max": 5 } }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Substring of document name, case-insensitive. | |
| type | No | PF2e item types (OR). | |
| level | No | Item level range; spell RANK for spells. | |
| limit | No | Page size 1..200, default 50. | |
| offset | No | Skip first N results. | |
| rarity | No | Rarity (OR). | |
| traits | No | ALL-OF: every listed trait must be present. Lowercase slugs. | |
| packIds | No | Restrict to these Item packs; omit for all. | |
| category | No | Feat category (OR): class, skill, general, ancestry, ... | |
| priceGold | No | Price range in gp (5 sp -> 0.5). | |
| traditions | No | ANY-OF: at least one shared tradition. |