Assuming you'd want to promote 200 products, but you only want to have 1 or 2 curated results per result page (chosen randomly). What would be the best way to approach this? I think curation doesn't support this use case right now. I guess I will have send a second query and pull the result out like that?

You can use pinned hits if you want more flexibility?

I'd still want them to be filtered out in case the user selects facets

Ok got it, it will be an interesting to see if we should support filtering on pinned hits as well.

but you only want to have 1 or 2 curated results per result page (chosen randomly)

The random part is the one that is not possible right now? Otherwise if you know your pagination order, you can still choose results at positions across pages.

Hmm didn't think about that, I can just spread them randomly across pages. Could it then happen that let's say product X is the best token match, but I randomly assigned it position 100, will it be shown twice or on page 10?

We currently have a "slide up" behavior where if you set position 100 but only 50 results are found, then it will just appear at the end.

hmm so I might "mess up" my search results doing it like that, for example I search for "ITEM XX" user searches for "ITEM XX", but it's pinned at pos 20 then "ITEM XX" would be shown at position 20 and before it would be: "ITEM XA", "ITEM XB" etc.., correct?

If you pin an item at position X then yes it won't appear higher even if the original ordering places it higher in the hits.

feels like a second request makes more sense, this way I can always choose the best matching product