TOPK.INCRBY key item increment [item increment ...]
Available in:
Redis Stack / Bloom 2.0.0
Time complexity:
O(n * k * incr) where n is the number of items, k is the depth and incr is the increment

Increase the score of an item in the data structure by increment. Multiple items' score can be increased at once. If an item enters the Top-K list, the item which is expelled is returned.


  • key: Name of sketch where item is added.
  • item: Item/s to be added.
  • increment: increment to current item score. Increment must be greater or equal to 1. Increment is limited to 100,000 to avoid server freeze.


Array reply of Simple string reply - if an element was dropped from the TopK list, Null reply otherwise..


redis> TOPK.INCRBY topk foo 3 bar 2 42 30
1) (nil)
2) (nil)
3) foo
Rate this page