Ingestion API client

The Ingestion API client is part of the algoliasearch package. You can install this package with pip:

1
pip install 'algoliasearch>=4,<5'

To use the Ingestion client, add this import to your files:

1
2
from algoliasearch.ingestion.client import IngestionClientSync
from json import loads

To create an instance of the client:

1
2
3
4
# In an asynchronous context, you can use IngestionClient instead, which exposes the exact same methods.
client = IngestionClientSync(
    "ALGOLIA_APPLICATION_ID", "ALGOLIA_API_KEY", "ALGOLIA_APPLICATION_REGION"
)

Replace ALGOLIA_APPLICATION_ID_REGION with your Algolia application’s analytics region: us for the United States or eu for Europe. You can check your analytics region in the Infrastructure > Analytics section of the Algolia dashboard.

Async code

To use the Ingestion client in async environments, add these imports instead:

1
2
import asyncio
from algoliasearch.ingestion.client import IngestionClient

The client supports the async with statement to automatically close open connections.

1
2
3
async def run():
    async with IngestionClient(ALGOLIA_APPLICATION_ID, ALGOLIA_API_KEY) as client:
        # client.search(...)

The method names are the same for synchronous and asynchronous methods.

List of methods

Each method makes one request to the Ingestion API.

Tasks

Authentications

Destinations

Sources

Transformations

Observability