How do I show maximum N results per some attribute value?

You can use distinct and attributeForDistinct for this purpose. For example, if each record has an id that is the same, you can use this as the attributeForDistinct, and set distinct to 2 to return 2 of the id value, although there may be more in your record set.