Endpoint histories
v1 searchOfferFacets
History for GET /v1/search/facets
GET /v1/search/facets — active. Recorded dates are not deployment dates.
2026-11-20 — Split search facets into a dedicated endpoint, default search facets to none, and add an opt-in card offer projection
Record: search-facets-and-card-projection.
- v1 GET /v1/search/facets (searchOfferFacets; added; compatible)
- Before: No dedicated facet endpoint existed; aggregations were only available alongside a page of offer hits from
GET /v1/search. - After: New
GET /v1/search/facetsaccepts the same filters asGET /v1/searchwithout pagination plus a comma-separatedfacetssection list (offerType,tags,technologies,developer,publisher,seller,price, orall; defaultall). It executes an OpenSearch aggregation query withsize: 0andtrack_total_hits: false, returns the requested aggregation body asdata, and returnsmeta.sectionsplusmeta.result. Thepricesection returnspriceStatswithcount,min,max,avg, andsum. Invalid sections, pagination parameters, inverted price ranges, and unsupported sorts return400. - Client action: Call once per filter section (for example
facets=tags) when the section is opened instead of requesting all facets with the result list.
- Before: No dedicated facet endpoint existed; aggregations were only available alongside a page of offer hits from
Verification: tests/search-route.test.ts; tests/rust-search-oracle.test.ts; cargo test -p egdata-routes-v1 search::; cargo test -p egdata-routes-legacy; cargo test -p egdata-openapi; pnpm openapi:check; pnpm docs:check.