npm · #3800

@algolia/recommend

5.57.0algolia/algoliasearch-client-javascript ↗

JavaScript client for recommend

Last release 9 days ago
18 Aug 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 58 of the last 60 stable releases
2 versions withdrawn
withdrawn after publishing
5 years old
271 releases · first in 2021

Release timeline

271 releases since 2021

20222023202420252026

Releases

4.23.126 Mar 2024
Release notes
v4.23.1
- fix(recommend): export recommend methods to use them in algoliasearch (#1512) (5fc5f4f), closes #1512
Open source →
4.23.026 Mar 2024
Release notes
v4.23.0
- feat(search): fetch recommendations directly from algoliasearch (#1509) (8087b28), closes #1509
Open source →
4.22.19 Jan 2024
Release notes
v4.22.1
- fix(recommend): update recommended-for-you model type (#1500) (f94ce64), closes #1500
Open source →
4.22.014 Dec 2023
Release notes
v4.22.0
- fix(recommend): update TrendingFacetHit facetValue type to string (#1498) (ac9d6e2), closes #1498
Why

The trending-facets API only returns type string for facetValue.

A follow-up on #1494 as other models return items/hits which are of type RecordWithObjectID

However, trending-facets model returns a list of TrendingFacetHit which (by definition) don't have an objectID property.

How

To simplify the code, we can remove the type argument TObject for trending-facets

Impact

If you're not using TypeScript or the trending-facets model, there is nothing to change. You can ignore the following.

Otherwise, you will need to remove the type argument passed to getTrendingFacets and the code goes from this:
```
type FacetType = {
  facetName: string;
  facetValue: string;
}
const { results } = await client.getTrendingFacets<FacetType>(/**/)
```
To this:
```
const { results } = await client.getTrendingFacets(/**/)
```
Open source →
4.21.112 Dec 2023
Release notes
v4.21.1
- fix(recommend): RecommendedForYouQuery userToken should be required (#1496) (d20b253), closes #1496
Open source →
4.21.011 Dec 2023
Release notes
v4.21.0
- feat(recommend): add recommended-for-you model (#1490) (004f033), closes #1490
- fix(recommend): getTrendingFacets typing (#1494) (94b46b5), closes #1494
- docs(readme): fix typo (#1486) (db9953c), closes #1486
Open source →
4.20.012 Sept 2023
Release notes
v4.20.0
- feat(search): add inference ACL to API key object (#1479) (3a95126), closes #1479
Open source →
4.19.120 Jul 2023
Release notes
v4.19.1
- fix(recommend): Add Type RecommendQueriesResponse from old MultipleQueriesResponse for recommend (#1472) (36285b2), closes #1472
Open source →
4.19.018 Jul 2023
Release notes
v4.19.0
- feat(abtests): add outlier count to variant response payload (#1467) (b88a726), closes #1467
- feat(recommend): add "Looking Similar" model (#1469) (01eac7f), closes #1469
Open source →
4.18.023 Jun 2023
Release notes
v4.18.0
- fix(types): union SearchForFacetValuesResponse type for multipleQueries (#1460) (6a786f1), closes #1460
- feat(cache-browser-local-storage): Implemented TTL support to cached items (#1457) (9092414), closes #1457
Open source →
4.17.28 Jun 2023
Release notes
v4.17.2
- fix(search): fix wait method for updateApiKey request (#1464) (edc629d), closes #1464
- docs(SearchOptions): fix jsdoc of sortFacetValuesBy (#1463) (a4309c7), closes #1463
Open source →
4.17.124 May 2023
Release notes
v4.17.1
- fix(recommend): Align getRecommendations type with actual implementation (#1459) (d18391b), closes #1459
Open source →
4.17.03 Apr 2023
Release notes
v4.17.0
- feat: update ab test typing (#1455) (f53c72c), closes #1455
- feat(fetch): remove mode option to rely on library's default (#1452) (67293e1), closes #1452
- feat(neural): make eventSources nullable (#1453) (eacfca2), closes #1453
Open source →
4.16.023 Mar 2023
Release notes
v4.16.0
- feat(neuralsearch): adding the semanticSearch settings to client-search (#1450) (a478ffd), closes #1450
- Fix for the redirect object in SearchResponse (#1443) (6b0685c), closes #1443
Open source →
4.15.02 Mar 2023
Release notes
v4.15.0
- feat: add mode to settings types (#1439) (89fd80e), closes #1439
Open source →
4.14.319 Dec 2022
Release notes
v4.14.3
- fix(recommend): remove unused trendingFacets props (#1433) (ffbfc05), closes #1433
- fix(recommend): update trending facets query props (RECO-1184) (#1434) (913443f), closes #1434
- docs: Fix incorrect property description (#1429) (ba59b68), closes #1429
Open source →
4.14.227 Jul 2022
Release notes
v4.14.2
- fix(types): add abTestID to SearchResponse (#1419) (05059f2), closes #1419
Open source →
4.14.120 Jul 2022
Release notes
v4.14.1
- fix(types): Updating searchoptions with explain attribute (#1415) (c46932e), closes #1415
Open source →
4.14.018 Jul 2022
Release notes
v4.14.0
- chore: mention next version in README (#1413) (100d180), closes #1413
- feat(fetch-requester): add @algolia/requester-fetch (#1411) (7b62403), closes #1411
Open source →
4.13.118 May 2022
Release notes
v4.13.1
- fix(search): add type for queryLanguages (#1406) (61c2976), closes #1406 #1405
Open source →
4.13.014 Mar 2022
Release notes
v4.13.0
- feat(recommend): Add trending types and methods (#1396) (6882ec8), closes #1396
Open source →
4.12.22 Mar 2022
Release notes
v4.12.2
- fix(types): allow mixed arrays in numeric and tag filters (#1395) (326c833), closes #1395
- fix(types): updating reRankingApplyFilter type and adding new property to RankingInfo (#1394) (e8f08ed), closes #1394
Open source →
4.12.128 Jan 2022
Release notes
v4.12.1
- fix(types): allow mix of strings and arrays in facetFilters (#1384) (dfc2a09), closes #1384
Open source →
4.12.07 Jan 2022
Release notes
v4.12.0
- feat(types): add reranking engine settings to types (#1378) (e9c0f30), closes #1378
- chore: clean up unused package and auto exports (#1315) (dfa7254), closes #1315
- chore: Configure Renovate (#1304) (f75924d), closes #1304
- chore: disable renovate until the test suite is less flaky (#1370) (8c8db3d), closes #1370
Open source →
4.11.020 Oct 2021
Release notes
v4.11.0
- fix(insideBoundingBox): allow strings (#1310) (87d5b0d), closes #1310
- feat: add custom request function (#1312) (3cea192), closes #1312
- feat(ts): document enableReRanking (#1306) (00ad924), closes #1306
- docs(recommend): add TSDoc (#1305) (a5df2fb), closes #1305
Open source →
4.10.526 Aug 2021
Release notes
v4.10.5
- fix(recommend): prevent undefined threshold (#1300) (7d21d3c), closes #1300
Open source →
4.10.423 Aug 2021
Release notes
v4.10.4
- fix(recommend): expose correct key on window in umd (#1298) (169b12a), closes #1298
Open source →
4.10.35 Jul 2021
Release notes
v4.10.3
- fix(answers): omit original hits in response (#1293) (fb62b15), closes #1293
- fix(facetOrdering): facetOrdering.facets, not .facet (d931976)
Open source →
4.10.223 Jun 2021
Release notes
v4.10.2
- fix(recommend): export method types (#1287) (95281fe), closes #1287
- chore(release): force public access on npm release (#1288) (2fefd78), closes #1288
Open source →
4.10.123 Jun 2021withdrawn: Not all packages were available
Nothing published for this version
4.10.023 Jun 2021withdrawn: Not all packages were available
Release notes
v4.10.0

The @algolia/client-recommendation is now deprecated, please use @algolia/client-personalization instead. If you were using initRecommendation from the algoliasearch package, please use initPersonalization instead.
- feat(recommend): introduce Recommend API client (#1280) (97ebde6), closes #1280 #1278
- feat(personalization): deprecate client-recommendation (#1278)
- fix(rules): automaticOptionalFacetFilters type takes the same input as automaticFacetFilters (#1279) (831a3de), closes #1279
Open source →

@algolia/recommend

Release timeline

Releases

Why

How

Impact