NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI, #2466 most downloaded on PyPI
A fully-featured and blazing-fast Python API client to interact with Algolia.
Latest stable
4.53.0
Last release 5 days ago
17 Nov 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
13 years old
228 releases · first in 2013
Drag across the ruler to compare, or tap a release to open it.
27351e7432 chore(specs): add description for Composition run response ( #7315 ) by @ClaraMuller
Full Changelog: 4.52.0...4.53.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
2d8e1605b3 feat(specs): expose abtesting-v3 user populations and no-results rate ( #7305 ) by @stevenMevans
Full Changelog: 4.51.0...4.52.0
e6933da012 fix(specs): clarify maxHitsPerQuery is a per-page limit ( #7210 ) by @kai687
algoliaDefined ordering in external sources (#7212) by @aiordacheFull Changelog: 4.49.0...4.51.0
c2153f09a5 fix(specs): remove obsolete index-key copy note ( #7177 ) by @xroche
Full Changelog: 4.48.0...4.49.0
BREAKING CHANGES: this minor version includes breaking changes (A/B Testing V3 API, Agent Studio API). See below for more details.
BREAKING CHANGES: this minor version includes breaking changes (A/B Testing V3 API, Agent Studio API). See below for more details.
pValue is now optional in the A/B test models. Update code that reads it as a required value.externalProvider source for CompAPI client (#7073) by @ClaraMullercreateAgentCompletion: the body type changed from AgentCompletionRequest to AgentCompletionRequestUnion.createAgent, updateAgent, getAgent: tool config models were renamed or merged (AlgoliaDisplayResultsToolConfig is now AlgoliaGroupedResultsToolConfig, AlgoliaRecommendToolConfigInput/Output are now AlgoliaRecommendToolConfig, ToolConfig is now ToolConfigOrBooleanUnion).MessagesUnionAgentConsolidateRequest, MessagesUnionAgentMemorizeRequest and MessagesUnionAgentPonderRequest were removed.Full Changelog: 4.47.0...4.48.0
BREAKING CHANGES: this minor version includes breaking changes in the A/B Testing V3 API. See below for more details.
BREAKING CHANGES: this minor version includes breaking changes in the A/B Testing V3 API. See below for more details.
Full Changelog: 4.45.0...4.47.0
3bee6d1dee chore(ci): pin all GitHub Action refs to commit SHAs (API-475) ( #6819 ) by @MarioAlexandruDan
Full Changelog: 4.44.4...4.45.0
ac68c1a79c fix(specs): add facetFilters back to recommend fallbackParameters ( #6727 ) by @raed667
Full Changelog: 4.44.3...4.44.4
97ea5bbb82 fix(python): downgrade release workflow to Python 3.13.14 and guard against 3.14 bumps ( #6687 ) by @Fluf22
Full Changelog: 4.44.2...4.44.3
a632f9fb75 fix(specs): BREAKING CHANGE – allow null records in getObjects response (#6582) by @Fluf22
getObjects operation now returns a list of nullable objects, as the API can send back null records. The clients previously only allowed a list of objects, so the response type has been updated to allow null values.Full Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.44.0...4.44.1
52ebd28f58 feat(clients): release Agent Studio package updates (#6573) by @Fluf22
Full Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.43.0...4.44.0
6a786c100e feat(clients): add IDisposable support and dispose the ingestion transporter on replacement (#6492) by @MarioAlexandruDan
Full Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.42.0...4.43.0
7f2ce8cd3a feat(clients): Agent Studio v1 (#6097) by @Fluf22
Full Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.41.1...4.42.0
a1c6d1df7f fix(python): pin release workflow to Python 3.13.x (#6473) by @Fluf22
Full Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.41.0...4.41.1
363cc2d91b fix(specs): Ingestion API - update destination payload (#6320) by @sbellone
Full Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.40.0...4.40.1
d275af4e18 feat(specs): add Algolia Index as a native connector in ingestion client (#6290) by @morganleroi
Full Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.39.0...4.40.0
BREAKING CHANGES: this minor version includes breaking changes in the Composition API. See below for more details.
BREAKING CHANGES: this minor version includes breaking changes in the Composition API. See below for more details.
Full Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.38.1...4.39.0
d86a5438e2 chore(deps): dependencies 2026-04-06 (#6200) by @algolia-bot
Full Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.38.0...4.38.1
b2387066c9 feat(python): added gzip compression (#6050) by @eric-zaharia
Full Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.37.1...4.38.0
505136c9d fix(specs): add deprecated field condition in rule schemas (#5983) by @MarioAlexandruDan
condition in rule schemas (#5983) by @MarioAlexandruDanFull Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.37.0...4.37.1
93c834fee feat(specs): add optional feedID to composition result set (#5991) by @gavinwade12
Full Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.36.1...4.37.0
4b3dc5c26 fix(specs): BREAKING CHANGE – remove unnecessary required fields (#5959) by @MarioAlexandruDan
SearchResponse model now accepts query and params as optional parameters, as they are not always returned by the API.redirect property to rule consequence schema (#5934) by @Fluf22Full Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.36.0...4.36.1
BREAKING CHANGES: this minor version includes multiple breaking changes related to fixes on different APIs. See below for more details.
BREAKING CHANGES: this minor version includes multiple breaking changes related to fixes on different APIs. See below for more details.
conditions is not required anymore in composition rules (#5853) by @ClaraMullerTrendingFacets model has been updated to reflect the API response.AuthenticationUpdate model has been updated to reflect that the type field can't be updated.CompositionBehavior model is now a union type for better accuracy.code property in oauth authentication (#5897) by @sbellone
AuthOAuth and AuthOAuthPartial models have been updated to reflect that the clientId field is now optional, and the code field can be set.Full Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.35.4...4.36.0
f02ab6fa0 chore: agentic config prep (#5825) by @Fluf22
Full Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.35.3...4.35.4
cd7a174b4 fix(specs): BREAKING CHANGE — remove fields requirement from run response in CompAPI client (#5809) by @ClaraMuller\ Some fields from the Co…
Full Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.35.2...4.35.3
762964fa3 chore: update Python version in release workflow to 3.13.7 (#5771) by @Fluf22
Full Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.35.1...4.35.2
5335918a5 chore(scripts): update the jira action (#5678) by @millotp
sortBy trigger on Composition Rules (#5707) by @ClaraMullerFull Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.34.0...4.35.0
6a48ef151a feat(specs): allow enablePersonalization query parameter at run time for Composition API (#5651) by @ClaraMuller
enablePersonalization query parameter at run time for Composition API (#5651) by @ClaraMullerFull Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.33.0...4.34.0
7d189e024 feat(specs): add useImagesObjects property in commercetools source input (#5586) by @sbellone
Full Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.32.0...4.33.0
ecfea56dc feat(clients): remove schedule capabilities (#5552) by @cdhawke
Full Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.31.0...4.32.0
d9b21b4b1 feat(specs): add renderingContent query parameter in Composition API main injection (#5549) by @ClaraMuller
renderingContent query parameter in Composition API main injection (#5549) by @ClaraMullerfacets query parameter in Composition API (#5477) by @ClaraMullerFull Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.30.0...4.31.0
9622cce01 chore(scripts): downgrade python version for release (#5482) by @millotp
facets query parameter available at run time (#5486) by @ClaraMullerFull Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.29.1...4.30.0
7de94353f feat(specs): add compositions deduplication setting (#5418) by @ben-kalmus
Full Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.28.0...4.29.0
ad51f60561 feat(specs): add partialNoCreate action to ingestion specs (#5389) by @shortcuts
Full Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.27.0...4.28.0
ca25c44e2 chore(deps): dependencies 2025-09-08 (#5310) by @algolia-bot
composition & composition-full (#5333) by @ClaraMullerFull Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.26.0...4.27.0
8f4abf3a1 fix(specs): Cross-reference filerPromotes to relevant guide (#5279) by @gazconroy
Full Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.25.0...4.26.0
40f3bebfde fix(clients): prefix tags with v (#5186) by @millotp
Full Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.24.0...4.25.0
66bc4eee9e feat(clients): add new abtesting-v3 package to clients + stabilize alpha js package (#5157) by @leonardogavaudan
Full Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.23.1...4.24.0
84a1f4e422 refactor(specs): add interface to manipulate query parameter between composition API & Search API (#5123) by @ClaraMuller
Full Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.23.0...4.23.1
a7a3c5fc95 feat(specs): document runMetadata parameter (#5087) by @DevinCodes
averageClickPosition return type (#5089) by @shortcutsFull Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.22.1...4.23.0
4c9416a9fe fix(specs): update sourceRun docs (#5057) by @DevinCodes
791a0c045d feat(specs): abtesting winsorizedAmount (#5053) by @cdhawke
a2ebbf496c feat(clients): add replaceAllObjectsWithTransformation (#5008) by @shortcuts
replaceAllObjectsWithTransformation (#5008) by @shortcutsreplaceAllObjectsWithTransformation (#5013) by @shortcutsFull Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.20.0...4.21.0
dc68c76106 chore(deps): dependencies 2025-06-09 (#4943) by @algolia-bot
Full Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.19.0...4.20.0
835daccb48 feat(specs): add with transformation helpers (#4931) by @shortcuts
Full Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.18.0...4.19.0
9db03b532b fix(specs): typo (#4854) by @kai687
Full Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.17.0...4.18.0
bebb56e0b9 fix(specs): add x-acl to insights endpoints (#4822) by @kai687
Full Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.16.5...4.17.0
53ac749807 chore(deps): dependencies 2025-04-28 (#4785) by @algolia-bot
Full Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.16.4...4.16.5
369c14232 fix(specs): condition cant be numeric filter (#4726) by @kai687
Full Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.16.3...4.16.4
a922dca5a docs(partialUpdate): add note about multiple operations (#4721) by @Jerska
ac400354a9 fix(specs): make the updateAt non-null in ingestion (#4697) by @millotp
Full Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.16.1...4.16.2
a51683025e chore: deprecate mcm methods (#4694) by @kai687
c3addb449 feat(specs): add CT Query predicate property (#4654) by @morganleroi
03a7074763 chore(deps): dependencies 2025-03-10 (#4566) by @algolia-bot
Full Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.14.0...4.15.0
ab623194e feat(specs): add subscriptionAction to ingestion specs (#4587) by @shortcuts
Full Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.13.3...4.14.0
5dd667ba1a chore(guides): some missing snippets + guides (#4477) by @Fluf22
Full Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.13.2...4.13.3
c0e70d9864 chore(deps): dependencies 2025-02-10 (#4432) by @algolia-bot
Full Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.13.1...4.13.2
ad43bfbdac guides: add missing snippets to docs (#4391) by @shortcuts
700441942e fix(specs): deprecate task v1 (#4327) by @millotp
Full Changelog: https://github.com/algolia/algoliasearch-client-python/compare/4.12.0...4.13.0
b569646304 fix(specs): drop singer from ingestion specs (#4281) by @shortcuts
One column per quarter.