The aggregation still happens at the level of the individual values of the

facet_by

parameter.

facet_return_parent

then just stuffs the parent object(s) inside the facet_counts response in the API for each of values