---
id: algoliasearch
version: "4.44.4"
license: MIT
license_treatment: permissive
maintenance: active
---

# algoliasearch — A fully-featured and blazing-fast Python API client to interact with Algolia.

License: permissive · Maintenance: active · Downloads: 3.2M/mo

## What it is and what it does

Algoliasearch is a low-level HTTP client library that wraps Algolia's search and indexing API for Python applications. It provides a thin interface to send requests to Algolia's servers, handle responses, and manage common operations like adding records to indices, searching with typo tolerance, and polling task status. The library supports both synchronous and asynchronous workflows through its dependencies on aiohttp and requests, making it flexible for different application architectures.

The package is designed as a starting point for developers integrating Algolia search into Python projects. It handles the mechanics of API communication—authentication, serialization, and response parsing—leaving application logic to the caller. Dependencies include aiohttp, requests, urllib3 for HTTP transport, pydantic for response validation, and python-dateutil for timestamp handling.

Use it for:

- Add, update, or delete records in a search index from a Python application
- Execute full-text searches with typo tolerance and retrieve ranked results
- Monitor indexing task completion by polling task status after bulk operations
- Integrate search functionality into a web application using the HTTP client
- Build semantic or neural search capabilities into an existing Python service

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A Python HTTP client for interacting with Algolia's search API, supporting both synchronous and asynchronous operations with built-in request handling and response parsing.

Yes. The package is actively maintained, has no known vulnerabilities, supports modern Python versions from 3.8.1 onward, and carries a permissive MIT license. Install friction is low and the dependency set is standard. Choose it if you need to integrate Algolia search into a Python project and want a straightforward, officially-supported client.

## Install

pip install algoliasearch
uv add algoliasearch
poetry add algoliasearch

## Installing algoliasearch

Before you install: Low installation friction with a pure-wheel distribution. Actively maintained with a release within the last 30 days and support for current Python versions (3.9 through 3.14).

License in practice: MIT license permits use, modification, and distribution with minimal restrictions, making it suitable for both open-source and commercial projects.

Quickstart:

pip install 'algoliasearch>=4.0,<5.0'

from algoliasearch.search.client import SearchClient

client = SearchClient("YOUR_APP_ID", "YOUR_API_KEY")
response = await client.save_object(
    index_name="index_name",
    body={"objectID": "id", "test": "val"}
)

Requires Python 3.8.1 or later; async operations require an async context or event loop.

Verify before relying:

- Whether sync and async patterns are equally supported or if async is primary
- Rate limiting, retry behavior, and error handling specifics beyond HTTP transport
- Performance characteristics under high-volume indexing or search workloads

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 3.2M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

algolia search client python, algolia api client, search indexing python, full-text search api, algolia integration, search engine client, async search client, search-api, async-http

[View on SkillFed](https://skillfed.io/packages/algoliasearch) · [View on PyPI](https://pypi.org/project/algoliasearch/)