Category pages
PULSE orders category and landing-page grids for whoever arrived, so a campaign that sends a thousand people to one page shows each of them the products they came for.
A campaign sends a thousand people to one category page, and all of them see the same grid. The shopper who came from a price-comparison link and the one who came from a gift guide want different products first. PULSE orders the grid against what each visit implies, with a held-back share of visits shown your default order, so the difference can be measured.
Who it is for: merchandisers running campaigns and landing pages, and any category with more products than fit above the fold.
The call
curl -X POST "https://api.thepulseapi.com/api/v1/catalog/ranked" \
-H "Content-Type: application/json" \
-H "x-api-key: pk_live_..." \
-d '{
"sessionId": "sess_abc123",
"organizationId": "org_abc123",
"categorySlug": "helmets-safety",
"page": 1,
"limit": 24
}'categorySlugtakes your own slug or a parent one; leave it out to rank the whole catalogue.- The whole category is ranked and
limit, up to 200, only decides how much comes back, so page two continues the same order. - Pass
signalson the same call to record what the visitor just did before ranking.
With the SDK: await pulse.rankedCatalog({ limit: 24 }). Reference:
POST /catalog/ranked.
Counts toward usage: yes, one request per page.
Recommendations
PULSE Recommendations rank a strip against the visit happening now, so a first-time shopper gets relevant picks without any purchase history. One call, alongside the page it sits on.
What the audit measures
Why the emptiest column is usually the wrong one to fix, what a bit of decision information buys, and the three cases where the ranking is wrong.

